H5R_DESTROY

Closes a reference

Procedure:

H5R_DESTROY ( ref_ptr )

Signature:

herr_t H5Rdestroy ( H5R_ref_t *ref_ptr )

Parameters:

H5R_ref_t * ref_ptr

IN: Pointer to reference
H5R_ref_t is defined in H5Rpublic.h as: typedef unsigned char H5R_ref_t[H5R_REF_BUF_SIZE];

Description:

Given a reference, ref_ptr, to an object, region or attribute attached to an object, H5R_DESTROY releases allocated resources from a previous create call.

Returns:

Returns a non-negative value if successful; otherwise returns a negative value.

Example:

examples / h5_ref_extern.c [84:87] hdf5_1_12 HDFFV/hdf5

    dset1 = H5Ropen_object((const H5R_ref_t *)&ref_buf[0], H5P_DEFAULT, H5P_DEFAULT);
    H5Dread(dset1, H5T_NATIVE_INT, H5S_ALL, H5S_ALL, H5P_DEFAULT, dset_buf);
    H5Dclose(dset1);
    H5Rdestroy(&ref_buf[0]);

History:

Release	Change
1.12.0	C function was introduced in this release.

--- Last Modified: December 16, 2019 | 03:34 PM

Page tree

H5R_DESTROY

Procedure:

Signature:

Parameters:

Description:

Returns:

Example:

History:

The HDF Group

Site

Resources

Connect