INQUIRE Specifier Keywords

The following provides a detailed list of the INQUIRE specifier keywords:

ACCESS=acc

• acc is a character variable that is assigned the value 'SEQUENTIAL' if the connection is for sequential I/O and 'DIRECT' if the connection is for direct I/O. The value is undefined if there is no connection.

BLANK=blnk

• blnk is a character variable that is assigned the value 'NULL' if null blank control is in effect for the file connected for formatted I/O, and 'ZERO' if blanks are being converted to zeros and the file is connected for formatted I/O.

DIRECT=dir

• dir is a character variable that is assigned the value 'YES' if the file could be connected for direct I/O, 'NO' if the file could not be connected for direct I/O, and 'UNKNOWN' if the system can't tell.

ERR=s

• s is a statement label of a statement to branch to if an error occurs during the execution of the INQUIRE statement.

EXIST=ex

• ex is a logical variable that is set to .TRUE. if the file or unit exists, and .FALSE. otherwise. If the file is a link, INQUIRE always returns .TRUE., even if the linked file does not exist.

FILE=fn

• n is a character expression or * with the name of the file. Trailing blanks in the file name are ignored. If the file name is all blanks, that means the current directory. The file need not be connected to a unit in the current program.

FORM=fm

• fm is a character variable which is assigned the value 'FORMATTED' if the file is connected for formatted I/O and 'UNFORMATTED' if the file is connected for unformatted I/O.

FORMATTED=fmt

• fmt is a character variable that is assigned the value 'YES' if the file could be connected for formatted I/O, 'NO' if the file could not be connected for formatted I/O, and 'UNKNOWN' if the system cannot tell.

IOSTAT=ios

• ios is as in the OPEN statement.

NAME=fn

• fn is a character variable that is assigned the name of the file connected to the unit. If you do an inquire-by-unit, the name parameter is undefined, unless both the values of the OPENED and NAMED variables are both true. If you do an inquire by file, the name parameter is returned, even though the FORTRAN 77 Standard leaves it undefined.

NAMED=nmd

• nmd is a logical variable that is assigned .TRUE. if the file has a name, .FALSE. otherwise.

NEXTREC=nr

• nr is an integer variable that is assigned one plus the number of the last record read from a file connected for direct access. If the file is not connect, -1 is returned in nr.

NUMBER=num

• num is an integer variable that is set to the number of the unit connected to the file, if any. If no file is connected, num is set to -1.

OPENED=od

• od is a logical variable that is set to .TRUE. if the file is connected to a unit or the unit is connected to a file, and .FALSE. otherwise.

RECL=rcl

• rcl is an integer variable that is assigned the record length of the records in the file if the file is connected for direct access. f77 does not adjust the rcl returned by INQUIRE. The OPEN statement does such an adjustment if the -xl[d] option is set. See "Details of Features That Require -xl[d]" for an explanation of -xl[d]. If no file is connected, rcl is set to -1.

SEQUENTIAL=seq

• seq is a character variable that is assigned the value 'YES' if the file could be connected for sequential I/O, 'NO' if the file could not be connected for sequential I/O, and 'UNKNOWN' if the system can't tell.

UNFORMATTED=unf

• unf is a character variable that is assigned the value 'YES' if the file could be connected for unformatted I/O, 'NO' if the file could not be connected for unformatted I/O, and 'UNKNOWN' if the system cannot tell.

UNIT=u

• u is an integer expression or * with the value of the unit. Exactly one of FILE or UNIT must be used.