[Back to Interface] [Prev] [Next]

Hdeldd

intn Hdeldd(int32 file_id, uint16 tag, uint16 ref)

file_id IN:

File identifier returned by Hopen

tag IN:

Tag of data descriptor to be deleted

ref IN:

Reference number of data descriptor to be deleted

Purpose

Deletes a tag and reference number from the data descriptor list.

Return value

Returns SUCCEED (or 0) if successful and FAIL (or -1) otherwise.

Description

Once the data descriptor is removed, the data in the data object becomes inaccessible and is marked as such. To remove inaccessible data from an HDF file, use the utility hdfpack.

Hdeldd only deletes the specified tag and reference number from the data descriptor list. Data objects containing the deleted tag and reference number are not automatically updated. For example, if the tag and reference number deleted from the descriptor list referenced an object in a vgroup, the tag and reference number will still exist in the vgroup even though the data is inaccessible.



[Back to Interface] [Prev] [Next]

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