Page tree

The license could not be verified: License Certificate has expired!

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »









Retrieves the object name for a referenced object


H5R_GET_OBJ_NAME ( ref_ptr, oapl_id, name, size )


ssize_t H5Rget_obj_name ( const href_t *ref_ptr, hid_t oapl_id, char *name, size_t size )

Replace this text with the Fortran function signature

const href_t *ref_ptrIN: Pointer to reference to query
hid_t oapl_idIN: Valid object access property list identifier
char *nameIN/OUT: A buffer to place the object name of the reference
size_t sizeIN: The size of the name buffer


H5R_GET_OBJ_NAME retrieves the object name for the object, region or attribute reference pointed to by ref_ptr. Up to size characters of the name are returned in name; additional characters, if any, are not returned to the user application. If the length of the name, which determines the required value of size, is unknown, a preliminary H5R_GET_OBJ_NAME call can be made. The return value of this call will be the size of the object name. That value can then be assigned to size for a second H5R_GET_OBJ_NAME call, which will retrieve the actual name. If there is no name associated with the object identifier or if the name is NULL, H5R_GET_OBJ_NAME returns the size of the name buffer (the size does not include the NULL terminator).

If the referenceis an object reference, name will be returned with a name for the referenced object. If the reference is a dataset region reference, name will contain a name for the object containing the referenced region. If the reference is an attribute reference, name will contain a name for the object the attribute is attached to. Note that an object in an HDF5 file may have multiple paths if there are multiple links pointing to it. This function may return any one of these paths.


Returns the length of the name if successful, returning 0 (zero) if no name is associated with the identifier. Otherwise returns a negative value.


Coming Soon!

1.12.0C function was introduced in this release.

--- Last Modified: August 15, 2019 | 02:38 PM