U_STAT - obtain latest status information.

Usage:

#include <ufas.h>
stat = u_stat( fp[, keyword] );

Where:

U_FILE fp;: is the file whose status is to be tested.
keyword;: is one of the keywords described below. This selects what information is returned. The default is "U_STATUS", the UFAS status bytes.
unsigned stat;: is the selected status of the file.

Description:

"u_stat" returns various pieces of information about an open file. No check is made on the relevance of the requested status (e.g. asking for number of records skipped when "u_pos" was never called with the U_FORW or U_BACK keywords is legal, but will result in undefined results).

Keywords:

Any of the following keywords may be supplied to "u_stat" to select the desired information.

U_STATUS: causes the two UFAS status bytes to be returned right-justified, zero-filled. This includes any changes performed by a user error procedure, or by UFAS after control is returned from such a procedure.
U_COUNT: returns the number of records skipped by the last call to "u_pos" with the U_FORW or U_BACK keyword.
U_RECLEN: returns the record length word (as updated by UFAS).
U_RELKEY: returns the current relative key (as updated by UFAS).