|
Remarks |
filenum&
is the handle of a currently open file. fattr is an integer
between -3 and 3 that specifies the type of information required, according
to the following table:
|
fattr |
Definition |
|
-3 |
The device type.
Returns 1 for a file, 2 for a device. COMM, TCP
and UDP are classified as devices. |
|
-2 |
Logical first byte (base)
position of a disk file. By default, PowerBASIC opens files with
a default first location of 1, but this can be overridden via the BASE=
clause of the OPEN statement. This
function can be useful when the base is not known or when performing SEEK
operations. |
|
-1 |
The minimum amount of
data that can be read or written at one time. For RANDOM
files, it is the record length. For INPUT
files, it is the input buffer length (set with LEN= in the OPEN statement).
For BINARY, OUTPUT
and APPEND, there is no buffering,
so it always returns 1 (1 byte). |
|
0 |
The
open state. TRUE (non-zero)
if open, FALSE (zero) if closed. |
|
1 |
The file mode (which may
be a combination of the following): |
|
|
(for example, an APPEND file
will return 8 + 2 = 10). |
|
2 |
The operating system file
handle for the file. This handle can be used with particular Windows
API calls files to manipulate files opened with PowerBASIC, and with the
OPEN HANDLE statement. |
|
3 |
Enumerates existing file
numbers. This mode enumerates existing file numbers, in the range
of 1 to 32767. FILEATTR(1,3) returns the first located file number,
FILEATTR(2,3) the second, and so on until -1 is returned to indicate that
there are no more file numbers active. The file numbers returned
are not guaranteed to be returned in any particular sequence, nor be open.
You can use FILEATTR(#filenum,0) to determine whether a given file number
is open or closed.
The number symbol [#] is optional, but recommended for clarity. |
|