WWW.NNC.IR
Macro Reference
571
8
Appendices
Vision System FH/FZ5 Series
User’s Manual (Z340)
Input$
Reads binary data from the file.
Format
Input$(<length>[, #<fikeNo>])
Parameter
Return value
Returns the read binary data value in the character string format.
Description
Reads specified size of binary data whose read size is specified in the <length> parameter from the file with
the specified file number in the <fileNo> parameter.
If a larger byte number than 255 is specified in the <length> parameter, the 255 byte data from the beginning
is read.
If a less byte number is specified in the <length> parameter than the byte number of data in the file to be
read, only the specified inte number of data is read. Unread data after the specified read range is read next
time the Input$ function is executed.
If the read data contains a double quoted character string, the double quotation marks (") are also read as
characters.
If a larger value than the byte number of all read data is specified in the <length> parameter, an "Illegal
function call" error will occur.
If an unopened file number is specified in the <fileNo> parameter, an "Illegal function call" error will occur.
If a file number of the opened file by a macro function other than the Open For Input As# function is specified
in the <fileNo> parameter, an "Illegal function call" error will occur.
If a value outside the range of 0 to 15 is specified in the <fileNo> 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, a "String too
long" 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
<length> Integer type Bytes number (0 to 255) of read data
<fileNo> Integer type Read file number (0 to 15)