WWW.NNC.IR
Macro Reference
591
8
Appendices
Vision System FH/FZ5 Series
User’s Manual (Z340)
Left$
Extracts the specified length of characters from the left side of character string.
Format
Left$(<string>, <length>)
Parameter
Return value
Returns the character string type value of the extracted character string.
Description
Extracts the specified length in the <length> parameter from the left side of specified character string in the
<string> parameter.
Specify the length of characters to be extracted in bytes for the <length> parameter. Each single-byte
character (i.e., half-width alphanumeric character and symbol) consumes one byte, whereas each double-
byte character consumes two bytes.
If the length specified in the <length> parameter is longer than the length of the character string specified in
the <string> parameter, the whole character string in the parameter is extracted.
If 0 or less number is specified in the <length> parameter, an "Illegal function call" error will occur.
If an incorrect data type is specified for a parameter, a "Type mismatch" error will occur.
If a value outside the range -2147483648 to 2147483647 is specified as an integer parameter, an "Overflow"
error will occur.
If a character string longer than 255 characters is specified for a character string parameter, the 255-
character string before the 256th character is used for the macro function processing. Characters after the
256th character will be discarded.
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.
Parameter
name
Data type Description
<string>
Character
string type
Extraction target character string
<length> Integer type Length of characters to be extracted (1 to the length of the target character string)
To Next Page
Loading...
Need help?
General
