H5I: Identifier Interface

Identifier API Functions

The C Interface:

H5Iget_type

The FORTRAN90 Interface:
In general, each FORTRAN90 subroutine performs exactly the same task as the corresponding C function. The links below go to the C function descriptions, which serve as general descriptions for both. A button, under Non-C API(s) at the end of the C function description, opens an external browser window displaying the FORTRAN90-specific information. You will probably want to adjust the size and location of this external window so that both browser windows are visible and to facilitate moving easily between them.

h5iget_type_f

Name: H5Iget_type

Signature:

H5I_type_t H5Iget_type(hid_t obj_id)

Purpose:

Retrieves the type of an object.

Description:

H5Iget_type retrieves the type of the object identified by obj_id.

Valid types returned by the function are

H5I_FILE	File
H5I_GROUP	Group
H5I_DATATYPE	Datatype
H5I_DATASPACE	Dataspace
H5I_DATASET	Dataset
H5I_ATTR	Attribute

If no valid type can be determined or the identifier submitted is invalid, the function returns

H5I_BADID

Invalid identifier

This function is of particular value in determining the type of object closing function (H5Dclose, H5Gclose, etc.) to call after a call to H5Rdereference.

Parameters:

hid_t obj_id

IN: Object identifier whose type is to be determined.

Returns:

Returns the object type if successful; otherwise H5I_BADID.

Non-C API(s):