Instruction Manual

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.