Find string length (len), C.7.2 find string length (len) – Nematron Pointe Controller User Manual

Page 411

Advertising
background image

Pointe Controller User Guide

Appendix C: Ladder Diagram Block Reference

409

NOTE: If the defined Element Length of the String variable configured to OUT is
smaller than the result of the function, then the result is truncated to fit. No
overflow error is generated.

C.7.2 Find string length (LEN)

When used in a Ladder Diagram, the LEN block finds the character length of a
string (variable or literal) and send it to output.

Select the

tool (from the

String Blocks

toolbar) and click on a ladder rung to

insert the following block:

Once the block is inserted, you can double-click on it to

configure

it.

Functional Description

This block always passes the Enable input state (EN) through to the Enable Out
output state (ENO) without change; when EN becomes on, ENO is turned on, and
when EN becomes off, ENO is turned off.

When EN becomes on, the block function is executed: the length (i.e., the
number of characters) of the Input String (IN) is determined and the result is
placed in the Output Value (OUT).

The block function is executed every time the ladder is

scanned

, so long as EN

remains on. If EN becomes off, then OUT remains at its last calculated value until
EN becomes on and the block function is executed again.

Configuration Reference

The parameters of this block are described in the following table:

Param

Name

Config

Var Type

Description

EN

Enable

no

-

The state of the rung (off/on)
received from the left.

ENO

Enable
Out

no

-

The state of the rung (off/on)
passed to the right.

IN

Input
String

req

String

Literal

The input string. Literals must be
enclosed in single quotes (‘ ’).

OUT

Output
Value

req

any integer*

The result of finding the length the

input string.

Advertising