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).
Copyright © 1996, Thinkage Ltd.