Page tree

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

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The H5R APIs were extended Information on the changes to references in HDF5-1.12 to support external references and attributes and to support the Virtual Object Layer (VOL). Information on these changes can be found below:

Anchor
description
description
Description

In order to support the new reference features several The H5R APIs were extended in HDF5-1.12 to support external references and attributes and to support the Virtual Object Layer (VOL). Several functions were introduced:

  • Create (H5R_CREATE*) functions were added for each reference type (attribute, object, and dataset region):
    H5R_CREATE_ATTR, H5R_CREATE_OBJECT, H5R_CREATE_REGION
    .
  • A function was added to release a reference (H5R_DESTROY). This is required because a region reference no longer modifies the original file.
  • Functions were added to query references (H5R_GET*):
    H5R_GET_ATTR_NAME, H5R_GET_FILE_NAME, H5R_GET_OBJ_NAME, H5R_GET_OBJ_TYPE3, H5R_GET_TYPE
    .
  • Other functions were added to simplify or clarify the API.

In order to support the Virtual Object Layer

...

See the RFC for details on the changes that were made.

Anchor
apis
apis
HDF5 Library APIs

The H5R functions that were introduce in HDF5-1.12 are described below.

FunctionDescription
H5R_COPYCopies an existing reference
H5R_CREATE_ATTRCreates an attribute reference
H5R_CREATE_OBJECTCreates an object reference
H5R_CREATE_REGIONCreates a region reference
H5R_DECODEDecodes a reference from a bufferH5R_DESTROYCloses a reference
H5R_ENCODEEncodes a reference into a bufferH5R_EQUALDetermines whether two references are equal
H5R_GET_ATTR_NAMERetrieves the attribute name for a referenced object
H5R_GET_FILE_NAMERetrieves the file name for a referenced object
H5R_GET_OBJ_NAMERetrieves the object name for a referenced object
H5R_GET_OBJ_TYPE3Retrieves the type of object that an object reference points to
H5R_GET_TYPERetrieves the type of reference
H5R_OPEN_ATTROpens the referenced HDF5 attribute
H5R_OPEN_OBJECTOpens the referenced HDF5 object
H5R_OPEN_REGIONSets up a dataspace and selection as specified by a region reference