Omron CX-PROGRAMMER V8.1 - Appendix C Function Descriptions; Standard Functions; Text String Functions

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.