Project

General

Profile

$fopen » History » Revision 4

Revision 3 (Per Amundsen, 12/08/2019 11:56 AM) → Revision 4/8 (Per Amundsen, 12/13/2019 06:33 PM)

_Added in 1.9.0_ 

 *$fopen(name|N)* 

 Returns information about an open file. 

 *Parameters* 

 name|N - Name of an open file, If N = 0 number of open files, otherwise the Nth open file. 

 *Properties* 

 .fname - Returns the name associated with the file. 
 .pos - Returns the current position in the file. 
 .eof - Returns [[$true]] if the position is as the end of the file, otherwise [[$false]]. 
 .err - TODO 
 .line - Returns the current line position. *(AdiIRC only)* (AdiIRC only) 

 *Example* 

 <pre> 
 ; Open a file. 
 /fopen Example Example.txt 

 ; Print number of open files. 
 //echo -ag $fopen(0) 

 ; Print information about the 'Example' file. 
 //echo -ag $fopen(Example) position is $fopen(Example).pos 

 ; Close the file. 
 /fclose Example 
 </pre>