[Back to Interface] [Prev] [Next]

Hgetelement

int32 Hgetelement(int32 file_id, uint16 tag, uint16 ref, uint8 *data)

file_id IN:

File identifier returned by Hopen

tag IN:

Tag of the data element to be read

ref IN:

Reference number of the data element to be read

data OUT:

Buffer the element will be read into

Purpose

Reads the data element for the specified tag and reference number and writes it to the data buffer.

Return value

Returns the number of bytes read if successful and FAIL (or -1) otherwise.

Description

It is assumed that the space allocated for the buffer is large enough to hold the data.



[Back to Interface] [Prev] [Next]

hdfhelp@ncsa.uiuc.edu
HDF Reference Manual - 07/29/98, NCSA HDF Development Group.