[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.