File
Top  Previous  Next

This objects provides functionality of file I/O operations.

Methods
 
open ( string File [, integer Mode =FILE_OPEN ] )  
 
Opens the existing log file or creates a new one.  
 
File – a string specifying the path and filename of the file to be open  
 
Mode – an optional enumerated integer that describes the mode at which the file will be open:  
 
   FILE_OPEN – opens an existing file for appending. If no such a file exist, creates it.  
 
   FILE_CREATE – creates a new file. If such a file exists, its content will be lost.  
 
write ( string Text )  
 
Writes a string of characters to the file.  
 
Test – a string containing the text to be written to the file.  
 
close ()  
 
Closes the file  
 
Error flags

ERR_OK  
 
The flag set if successful.  
ERR_FAILED  
 
The flag set if failed.  
ERR_NOTFOUND  
 
The flag set if the file was not found.  
ERR_BADFILE  
 
The flag set if the file could not be created.  
ERR_NOSPACE  
 
The flag set if there is not enough space to write the file.  
 
Examples

This set statements opens a log file and writes the current time into it:  
 
File.Open( "c:\newlog.txt" )  
File.Write(getTime())  
File.Close()