Omron SYSMAC FH Series User Manual

WWW.NNC.IR
Macro Reference
637
8
Appendices
Vision System FH/FZ5 Series
User’s Manual (Z340)
Piece$
Extract the part of the character string which was separated by delimiter from the string.
Format
Piece$(<string>, <delimiter>, <start>, <end>)
Parameter
Return value
Returns the character string type value of the extracted character string.
Description
Extracts the character string portions from the starting index number specified in the <start> parameter to the
ending index number specified in the <end> parameter after assigning index numbers to the portions
separated with the separator string specified in the <delimiter> parameter.
If the character string in the <string> parameter cannot be separated with the character string in the
<delimiter> parameter, all characters in the character string is extracted as a portion.
Specify the starting index number to be extracted in the <start> parameter. The index numbers are assigned
to the portions in ascending order starting with 1 to the first portion.
If a larger value than the number of separated portions is specified in the <start> parameter, an "Illegal
function call" error will occur.
If the index number specified in the <end> parameter is larger than the index number specified in the <start>
parameter, an "Illegal function call" error will occur.
If 0 or smaller value is specified in the <start> parameter or <end> parameter, an "Illegal function call" error
will occur.
If a larger value than the number of separated portions is specified in the <end> parameter, all portions from
the starting index number in the <start> parameter to the end of the character string are extracted.
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 in the <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.
Parameter
name
Data type Description
<string>
Character
string type
Extraction target character string
<delimiter>
Character
string type
Character string delimiter
<start> Integer type
Index number of the character string that the extraction is started (Number 1 to number
of substrings)
<end> Integer type
Index number of the character string that the extraction is finished (Number 1 to number
of substrings)

Omron SYSMAC FH Series Specifications

General

Brand	Omron
Model	SYSMAC FH Series
Category	Industrial Equipment
Language	English