.FGPOS - get the current read/write position as a structure.

Usage:

B:
   %b/manif/fpos_t
   .fgpos( unit, fpos_ptr );

/* C users use "fgetpos" */

Where:

unit

is the unit whose read/write position you want to determine.

fpos_ptr

points to a vector whose size should be declared as FP.SZ (a manifest defined in "b/manif/fpos_t"). .FGPOS fills this vector with a "seek structure" that gives the current read/write position.

Description:

.FGPOS determines the current read/write position in a file. It represents this position with an "fpos_t" structure, identical to the structure used by the "fgetpos" function of SS mode C.

The seek structure obtained by .FGPOS can be used in future calls to .FSPOS in order to return to the current read/write position.

See Also:

expl b lib .fspos

to use structures obtained by .FGPOS.

expl b lib .tell

for a function that represents the current read/write position as an integer rather than a structure.

Copyright © 1996, Thinkage Ltd.