Write, Writeln – Argox PA-20 Programming Guide User Manual

Page 48

Advertising
background image

PT-20 Programming Guide

46

fErrorCode: 2:File handle is NULL.

7:fd is not a file handle of a previously opened file.

write

Purpose: Write a specified number of bytes to a DAT file.

Syntax: int write(int fd, char *buffer, unsigned count);

Example call: write(fd, data_buffer,100);

Includes:

#include “SDK.h ”

Description: The write function writes the number of bytes specified in the

argument count from the character array buffer to a DAT file

whose file handle is fd. Writing of data starts at the current

position of the file pointer, which is incremented accordingly

when the operation is completed.

If the end-of- file condition is encountered during the operation,

the file will be extended automatically to complete the operation.

Returns: The write function returns the number of bytes actually written to

the file. In case of error, write returns an integer value of -1 and

an error code is set to the global variable fErrorCode to indicate

the error condition encountered. Possible error codes and their

interpretation are listed below.

fErrorCode: 2:File handle is NULL.

7:fd is not a file handle of a previously opened file.

10:No more free file space for file extension.

writeln

Purpose: Write a line terminated by a null character (\0) to a DAT file.

The null character is also written to the file. After writing in, file

position will update.

Syntax: int writeln(int fd, char *buffer);

Example call: writeln(fd, data_buffer);

Includes:

#include “SDK.h ”

Description: The writeln function writes a line terminated by a null character

from the character array buffer to a DAT file whose file handle is

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 position of the file pointer, which is

incremented accordingly when the operation is completed. If the

end-of-file condition is encountered during the operation, the file

will be extended automatically to complete the operation.

Returns: The writeln function returns the number of bytes actually written

Advertising