Flexible NC programming
1.20 Read lines in the file (READ)
Job planning
138 Programming Manual, 07/2010, 6FC5398-2BP40-0BA0
1.20 Read lines in the file (READ)
Function
The READ command reads one or several lines in the specified file and stores the information
read in an STRING type array. In this array, each read line occupies an array element.
Note
The file must be stored in the NCK's static user memory (passive file system).
Condition
The currently set protection level must be equal to or greater than the READ right of the
file. If this is not the case, access is denied with an error message (return value of error
variable = 13).
Syntax
DEF INT <error>
DEF STRING[<string length>] <result>[<n>,<m>]
READ(<error>,"<file name>",<start line>,<number of lines>,<result>)
Significance
READ: Command for reading lines from the specified file and storing these
lines in a variable array.
Variable for returning the error value (call-by-reference parameter)
Type. INT
0 No error
1 Path not allowed
2 Path not found
3 File not found
4 Incorrect file type
13 Insufficient access rights
21 Line does not exist (
<start line> or <number of
lines>
parameter exceeds the number of lines in
the specified file).
22 Field length of the result variable (
<result>) is too
small.
<error>:
Value:
23 Line range too large (
<number of lines>
parameter selected so large that the read would
go beyond the end of the file).