AdiIRC

_Added in 1.9.0_

*$fopen(name|N)*

Returns information about an open file.

_See also {{/fopen]], [[/fclose]], [[/fwrite]], [[/fseek]], [[/flist]], [[$fread]], [[$fgetc]], [[$feof]], [[$ferr]]._

*Parameters*

table(ktable).

|*Parameter*|*Description*|

| name<notextile>|</notextile>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>