.FSPOS - seek to new position in file, using seek structure.

Usage:

B:
   %b/manif/fpos_t
   status = .fspos( unit, fpos_ptr ) ;

/* C users use "fsetpos" */

Where:

unit

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

fpos_ptr

points to a seek structure, as returned by .FGPOS.

status

is zero if the operation succeeded and non-zero otherwise.

Description:

.FSPOS moves the current read/write position to a different location in a file. You specify the desired location using a seek structure, a vector obtained through a call to .FGPOS. The size of this vector should be declared as FP.SZ, a manifest defined in "b/manif/fpos_t".

See Also:

expl b lib .fgpos

for determining the current read/write position as a seek structure.

expl b lib .seek

for move to a different file location using a seek integer instead of a seek structure.

Copyright © 1996, Thinkage Ltd.