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