[Top]
[Prev]
[Next]
[Bottom]
VHstoredata/vhfsd/vhfscd
int32 VHstoredata(int32
file_id
, char *
fieldname
, uint8
buf
[], int32
n_records
, int32
data_type
, char *
vdata_name
, char *
vdata_class
)
file_id
IN:
File identifier returned by
Hopen
fieldname
IN:
Field name for the new vdata
buf
IN:
Buffer the records to be read
n_records
IN:
Number of records to be stored
data_type
IN:
Data type for the field in each record
vdata_name
IN:
Name of the vdata to be created
vdata_class
IN
Class of the vdata to be created
Purpose
Creating vdatas containing records limited to one field with one component per field.
Return value
Reference number of newly-created vdata if successful, FAIL (or -1) otherwise
Description
This routine provides a high-level method for creating single-order, single-field vdatas. It creates a vdata named
vdata_name
of class
vdata_class
in the HDF file referenced by
file_id
. The data type of the field is specified by
data_type
and
n_records
of data from buf are stored with a field name specified by
fieldname
.
Because
Vstart
initializes the VH interface, it must precede
VHstoredata
. It is not necessary, however, to call
VSattach
or
VSdetach
in conjunction with
VHstoredata
.
Note that there are two Fortran-77 versions of this routine; one for buffered numeric data (
vhfsd
) and the other for buffered character data (
vhfsdc
).
FORTRAN
integer function vhfsd(file_id, fieldname, buf, n_records,
data_type, vdata_name, vdata_class)
integer file_id, n_records, data_type
character* (*) access, vdata_name, vdata_class
<valid numeric data type> buf(*)
integer function vhfscd(file_id, fieldname, buf, n_records,
data_type, vdata_name, vdata_class)
integer file_id, n_records, data_type
character* (*) access, vdata_name, vdata_class
character* (*) buf
[Top]
[Prev]
[Next]
[Bottom]
hdfhelp@ncsa.uiuc.edu
HDF User's Reference Manual, Draft 06/09/97, NCSA HDF Development Group.