[Top]
[Prev]
[Next]
[Bottom]
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.
[Top]
[Prev]
[Next]
[Bottom]
hdfhelp@ncsa.uiuc.edu
HDF User's Reference Manual, Draft 06/09/97, NCSA HDF Development Group.