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