Metrologic Optimus R, Programming Manual

Page: 204 / 241

198 "C" Programming Guide For Optimus S/R
Example write (fd, data_buffer);
Description This routine writes a null-terminated string from the character array buffer to a
DAT file ( fd ).
Characters are written to the file until a null character (\0) is encountered.
The null character is also written to the file.
Writing of data starts at the current file pointer position, which is
incremented accordingly when the operation is completed.
If end-of-file is encountered during operation, this routine will
automatically extend the file size to hold the data written.
Return
If successful, it returns the number of bytes actually written to the file,
including the null character.
On error, it returns -1.
An error code is set to the global variable fErrorCode to indicate the error
condition encountered. Below are possible error codes and their interpretation.
Error Code Interpretation
2 File specified by fd does not exist.
4 File specified by fd is not a DAT file.
7 Invalid file handle.
8 File not opened.
10 No free file space for file extension.
11 Cannot find string terminator in
buffer
.
See Also append, appendln, read, readln, write