WWW.NNC.IR
Macro Reference
621
8
Appendices
Vision System FH/FZ5 Series
User’s Manual (Z340)
Mid$
Extract a part from the character string.
Format
Mid$(<string>, <start>, <length>)
Parameter
Return value
Returns the character string type value of the extracted character string.
Description
Extracts the specified length of the character string in the <length> parameter after the positon specified in
the <start> parameter from 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 between the
<start> parameter position and the end of the character string, the all characters from the <start> parameter
position to the end of the character string are extracted.
If a larger value than the length of the target character string is specified in the <start> parameter, an "Illegal
function call" error will occur.
If 0 or smaller value is specified in the <start> parameter or <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
<start> Integer type Starting position of extraction (1 to the length of the target character string)
<length> Integer type
Length of characters to be extracted (1 to the remaining length from specified starting
position)