Read String from File

\i S r byte::handle char::endchar

Parameter	Type	Range	Description
byte	handle	0 ... 3	unique identifier for opened file
endchar	byte	ASCII char (0x01 ... 0xFF)	ending character to read up to

Reads string data from a previously opened file (same as Read File), but the number of bytes returned is determined by the byte value of endchar.

Note

Data is read until either the end character endchar is found or the end of file is reached. In the latter case, the end character is appended although it is not found in the file and a [NACK] is sent at the end of the response.
The file pointer is then set to the byte after the last byte read.
When end of file condition exists at the beginning of the read command, no data is sent at all, just a [NACK] is sent and the error code is set to END_OF_FILE (see Error Codes).

Response:

[ACK] data [ACK]

Example

\iSO\1A/CSV.TXT\0
\iSr\1;

Opens the file "CSV.TXT" in the root folder with handle 1 in append mode and reads data until a ';' character is found.

Response Example

[ACK]1,2,3,4,5;[ACK]

The file contains ascending ASCII values, the file pointer is moved after the last byte read (in this case position 10). In a comma separated text file, sending the same (second) command again would read the next line.

Not supported by: DPC3050, DPC3020, DPC2060, DPC10xx