[Top] [Prev] [Next] [Bottom]

VHstoredatam/vhfsdm/vhfscdm

int32 VHstoredatam(int32 file_id, char *fieldname, uint8 buf[], int32 n_records, int32 data_type, char *vdata_name, char *vdata_class, int32 order)
file_id

IN:

File identifier returned by Hopen

fieldname

IN:

Field name for the new vdata

buf

IN:

Buffer the records are to be read from

n_records

IN:

Number of records to be stored

data_type

IN:

Data type of data elements

vdata_name

IN:

Name of the vdata to be created

vdata_class

IN:

Class of the vdata to be created

order

IN:

Number of components per field

Purpose

Creates vdatas containing records with one field containing one or more components.

Return value

Reference number of the newly-created vdata if successful, FAIL (or -1) otherwise

Description

This routine provides a high-level method for creating multi-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 vdata and all its components is specified by data_type and n_records of data from buf are stored with a field name specified by fieldname. The order of the vdata indicates the number of data values stored per field.

Because Vstart initializes the VH interface, it must precede VHstoredatam. It is not necessary, however, to call VSattach or VSdetach in conjunction with VHstoredatam.

Note that there are two Fortran-77 versions of this routine; one for buffered numeric data (vhfsdm) and the other for buffered character data (vhfscdm).

g
FORTRAN

integer function vhfsdm(file_id, fieldname, buf, n_records,

data_type, vdata_name, vdata_class

order)

integer file_id, n_records, data_type, order

character* (*) access, vdata_name, vdata_class

<valid numeric data type> buf(*)

integer function vhfscdm(file_id, fieldname, buf, n_records,

data_type, vdata_name, vdata_class

order)

integer file_id, n_records, data_type, order

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.