[Top]
[Prev]
[Next]
[Bottom]
VSseek/vsfseek
int32 VSseek(int32
vdata_id
, int32
record
)
vdata_id
IN:
Vdata access identifier returned from
VSattach
record
IN:
Target record number
Purpose
Provides a mechanism for random-access I/O within a vdata.
Return value
Returns the record position (zero or a positive integer) if successful and FAIL (or -1) otherwise.
Description
This routine moves the access pointer within the vdata
vdata_id
to the position of the record specified by
record
. The next call to
VSread
or
VSwrite
will read the current record.
For example, to seek to the third record in the vdata, set
record
to 2. The first record position is specified by specifying a
record
value of 0. Each seek is constrained to a record boundary within the vdata.
FORTRAN
integer function vsfseek(vdata_id, record)
integer vdata_id, record
[Top]
[Prev]
[Next]
[Bottom]
hdfhelp@ncsa.uiuc.edu
HDF User's Reference Manual, Draft 06/09/97, NCSA HDF Development Group.