Alternate Entry Name: .GTREC
B: status = getrec( [unit,] vector [, max ] );
C: int getrec( [FILE *unit,] void *vector [, int max] );
GETREC moves the current record (up to "max" words + rcw) to "vector", so that the next record becomes the current record. GETREC assumes that a GFRC standard system format file is being read. Records with media codes 8, 11, 12, 14 or 15 are discarded.
If the logical record begins a spanned or partitioned record, the I/O package will combine the logical records of the set into one big record with an appropriate rcw.
The RCW placed in "vector[0]" decribes the date returned. If the actual input was too long the remainder of the record will be quietly discarded. If you want to check for a record longer than N words (not counting the RCW) you must call GETREC with "max" set to N+1, and then examine RCW.
Copyright © 1996, Thinkage Ltd.