Project

General

Profile

$fopen » History » Revision 6

Revision 5 (Per Amundsen, 12/14/2019 10:01 AM) → Revision 6/8 (Per Amundsen, 02/22/2023 04:48 PM)

_Added in 1.9.0_ 

 *$fopen(name|N)* 

 Returns information about an open file. 

 *Parameters* 

 table(ktable). 
 |*Parameter*|*Description*| 
 | name<notextile>|</notextile>N | name|N - Name of an open file, If N = 0 number of open files, otherwise the Nth open file. | 

 *Properties* 

 table(ktable). 
 |*Property*|*Description*| 
 | .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)* | 

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