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 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 |
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.