Writes data to the file associated with the specified file number. The file number was assigned to the file with the FileOpen function.
FileWriteEx ( file#, blob )
FileWriteEx ( file#, string )
Argument |
Description |
|---|---|
file# |
The integer assigned to the file when the file was opened |
blob or string |
A blob or string whose value is the data you want to write to the file. |
Long. Returns the number of bytes written if it succeeds and -1 if an error occurs. FileWriteEx returns -1 if you attempt to write to a string in stream mode or to a blob in line mode. If any argument’s value is null, FileWriteEx returns null.
FileWriteEx returns long
Unlike the FileWrite function that it replaces,
the FileWriteEx function returns a long value.
FileWriteEx writes its data at the position identified by the file pointer. If the file was opened with the writemode argument set to Replace!, the file pointer is initially at the beginning of the file. After each call to FileWriteEx, the pointer is immediately after the last write. If the file was opened with the writemode argument set to Append!, the file pointer is initially at the end of the file and moves to the end of the file after each write.
FileWriteEx sets the file pointer following the last character written. If the file was opened in line mode, FileWriteEx writes a carriage return (CR) and linefeed (LF) after the last character in variable and places the file pointer after the CR and LF.
If the file was opened in stream mode, FileWriteEx writes the full contents of the string or blob.
This script excerpt opens EMP_DATA.TXT and writes the string New Employees on a new line at the end of the file. The variable li_FileNum stores the number of the opened file:
integer li_FileNum
li_FileNum = FileOpen("C:\HR\EMP_DATA.TXT", &
LineMode!, Write!, LockWrite!, Append!)
FileWriteEx(li_FileNum, "New Employees")
The following example reads a blob from the database and writes it to a file. The SQL SELECT statement assigns the picture data to the blob Emp_Id_Pic. Then FileOpen opens a file for writing in stream mode and FileWriteEx writes the blob to the file:
integer li_FileNum
blob emp_id_pic
SELECTBLOB salary_hist INTO : emp_id_pic
FROM Employee WHERE Employee.Emp_Num = 100
USING Emp_tran;
li_FileNum = FileOpen("C:\EMPLOYEE\EMP_PICS.BMP", &
StreamMode!, Write!, Shared!, Replace!)
FileWriteEx(li_FileNum, emp_id_pic)
