Omron SYSMAC FH Series

WWW.NNC.IR
Macro Reference
593
8
Appendices
Vision System FH/FZ5 Series
User’s Manual (Z340)
Len
Gets the length of the specified character string.
Format
Len(<string>)
Parameter
Return value
Returns the character string length in bytes as an integer value.
Description
Gets the length of the specified character string in the <string> parameter in bytes.
Each single-byte character (i.e., half-width alphanumeric character and symbol) consumes one byte,
whereas each double-byte character consumes two bytes.
If an incorrect data type is specified for a parameter, a "Type mismatch" error will occur.
Even if a character string longer than 255 characters is specified for a character string parameter, an error will
not occur.
If a value is assigned to the return value variable or the variable is not used in an expression, a "Syntax error"
error will occur.
If the format is written incorrectly, such as writing the macro function name incorrectly, omitting a comma, or
omitting a half-width space, a "Syntax error" error will occur.
Usage Cautions
• None.
Example
Gets the length of the character string "OMRON".
The result is shown below.
Useable Modules
Unit Calculation Macro / Scene Control Macro / Communication Command Macro / Unit Macro
Supported Versions
Version 3.50 or later
Parameter
name
Data type Description
<string>
Character
string type
Character string to be gotten the length of
CHRLEN& = Len("OMRON")
CHRLEN& = 5