[Back to Interface] [Prev] [Next]

Hexist

intn Hexist(int32 h_id, uint16 search_tag, uint16 search_ref)

h_id IN:

Access identifier returned by Hstartread, Hstartwrite, or Hnextread

search_tag IN:

Tag of the object to be searched for

search_ref IN:

Reference number of the object to be searched for

Purpose

Locates an object in an HDF file.

Return value

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

Description

Simple interface to Hfind that determines if a given tag/reference number pair exists in a file. Wildcards apply.

Hfind performs all validity checking; this is just a very simple wrapper around it.



[Back to Interface] [Prev] [Next]

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