Writes data into a specified file.

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

nFileHandle (input)

Specify a file handle.

strWriteData (input)

Specify data to be written into a file.

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 number	Error code
5	ERROR_ACCESS_DENIED
6	ERROR_INVALID_HANDLE
8	ERROR_NOT_ENOUGH_MEMORY
14	ERROR_OUTOFMEMORY
19	ERROR_WRITE_PROTECT
21	ERROR_NOT_READY
32	ERROR_SHARING_VIOLATION
33	ERROR_LOCK_VIOLATION
38	ERROR_HANDLE_EOF
112	ERROR_DISK_FULL
148	ERROR_PATH_BUSY
1231	ERROR_NETWORK_UNREACHABLE
1392	ERROR_FILE_CORRUPT

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.