AIT_FilePutLine

Description

Writes data into a specified file.

Format

bool AIT_FilePutLine  (
 integer nFileHandle,     // File handle
 string strWriteData      // Data to be written into a file
);

Parameters

nFileHandle (input)

Specify a file handle.

strWriteData (input)

Specify data to be written into a file.

Return values

The return value is true if the function was executed normally, and false if not. If the function has returned false, you can use AIT_GetLastError to acquire an extended error code. The following gives the error codes that AIT_GetLastError might return:

Extended error numberError code
5ERROR_ACCESS_DENIED
6ERROR_INVALID_HANDLE
8ERROR_NOT_ENOUGH_MEMORY
14ERROR_OUTOFMEMORY
19ERROR_WRITE_PROTECT
21ERROR_NOT_READY
32ERROR_SHARING_VIOLATION
33ERROR_LOCK_VIOLATION
38ERROR_HANDLE_EOF
112ERROR_DISK_FULL
148ERROR_PATH_BUSY
1231ERROR_NETWORK_UNREACHABLE
1392ERROR_FILE_CORRUPT

Notes

If you specify that zero bytes be written, the system considers that null writing operations are specified.

The AIT_FilePutLine function writes data at the current file pointer position, which is updated after writing operations.