Omron SYSMAC CX-Programmer 9, Operation Manual

Page: 213 / 232

187
Appendix C
Function Descriptions
Standard Functions
Text String Functions
LEN: Detect String Length
• Function
Finds the length of a specified text string.
• Application
Return_value := LEN(string);
• Arguments and Return Values
• Example
LEFT: Extract Characters from Left
• Function
Extracts the specified number of characters from the left of the specified text string.
• Application
Return_value := LEFT (Source_string, Number_of_characters) ;
• Arguments and Return Values
• Example
RIGHT: Extract Characters from Right
• Function
Extracts the specified number of characters from the right of the specified text string.
• Application
Return_value := RIGHT (Source_string, Number_of_characters) ;
Variable name Data type Description
String STRING Specifies the text string for
which to find the length.
Return_value INT Returns the size of the speci-
fied text string.
Variable name Data type Description
Source_string STRING Specifies the text string from which to
extract characters.
Number_of_characters INT, UINT Specifies the number of characters to
extract.
Return_value STRING Returns the extracted characters.
A B C D E F G H
Variables
STRING Message
INT Result
Message
Result:=LEN(Message);
→
"8" is stored in Result variable.
A B C D E F G H
Message
Variables
STRING Message
STRING Result
Result:=LEFT(Message,3);
→
"ABC" is stored in the Result variable.