U_GET - get a random record from a UFAS file.

Usage:

#include <ufas.h>
stat = u_get( buffer, maxbytes, fp[, relkey] );
stat = u_get(buffer, maxbytes, fp[, keynum[, keyptr ]])

Where:

char *buffer;

is a pointer to the buffer into which the record should be placed.

int maxbytes;

is the maximum number of characters to read.

U_FILE fp;

is the file from which to read.

unsigned relkey;

is the relative key of the record to be read. The default is the key of the last record read, written, or positioned to.

int keynum;

is the key number of the key by which the record should be located. The default is the last key of reference, from a previous call to "u_pos" or "u_get".

char *keyptr;

is a pointer to the key to search for. The default is the key of the last record read or written.

int stat;

is the number of characters actually read, or EOF on error.

Description:

"u_get" reads a specified record from a UFAS relative or indexed file open in random or dynamic mode. (I.e. "b" or "bl" actions were specified on open.)

Notes:

If this is used on a file opened for sequential access, the program will probably be aborted with "illegal call on file XX".

See Also:

expl c ufas u_gxt

expl c ufas u_open

Copyright © 1996, Thinkage Ltd.