Page tree

 

JAVA

FORTRAN

C++

C

 

Link

H5I_ITERATE

Calls a callback for each member of the identifier type specified

Procedure:

H5I_ITERATE ( type, op, op_data )

Signature:

herr_t H5Iiterate ( H5I_type_t type, H5I_iterate_func_t op, void *op_data )

Parameters:
H5I_type_t typeIN: The identifier type
H5I_iterate_func_t opIN: The callback function
void *op_dataIN: The data for the callback function

Description:

H5I_ITERATE calls the callback function op for each member of the identifier type type. The callback function type for op, H5I_iterate_func_t, is defined in H5Ipublic.h as:

typedef herr_t (*H5I_iterate_func_t)(hid_t id, void *udata);

op takes as parameters the identifier and a pass through of op_data, and returns an herr_t.

A positive return from op will cause the iteration to stop and H5I_ITERATE will return the value returned by op.  A negative return from op will cause the iteration to stop and H5I_ITERATE will return failure.  A zero return from op will allow iteration to continue, as long as there are other identifiers remaining in type.

H5I_type_t is defined in H5Ipublic.h in the HDF5 source code.  Valid H5I_type_t values for use with H5I_ITERATE are:
    H5I_FILE        = 1,        /* type ID for File objects                     */
    H5I_GROUP,                  /* type ID for Group objects                    */
    H5I_DATATYPE,               /* type ID for Datatype objects                 */
    H5I_DATASPACE,              /* type ID for Dataspace objects                */
    H5I_DATASET,                /* type ID for Dataset objects                  */
    H5I_MAP,                    /* type ID for Map objects                      */
    H5I_ATTR,                   /* type ID for Attribute objects                */
    H5I_VFL,                    /* type ID for virtual file layer               */
    H5I_VOL,                    /* type ID for virtual object layer             */
    H5I_GENPROP_CLS,            /* type ID for generic property list classes    */
    H5I_GENPROP_LST,            /* type ID for generic property lists           */
    H5I_ERROR_CLASS,            /* type ID for error classes                    */
    H5I_ERROR_MSG,              /* type ID for error messages                   */
    H5I_ERROR_STACK,            /* type ID for error stacks                     */
    H5I_SPACE_SEL_ITER,         /* type ID for dataspace selection iterator     */

 

Limitation

 Currently there is no way to start searching from where a previous search left off.

 

Returns:

The last value returned by op

Example:

None

History:
ReleaseChange
1.12.0Function introduced in this release.

--- Last Modified: February 24, 2020 | 08:59 AM