Page tree

 

JAVA

FORTRAN

C++

C

 

Link

H5A_OPEN

Opens an attribute for an object specified by object identifier and attribute name

Procedure:

H5A_OPEN (obj_id, attr_name, aapl_id)

Signature:

hid_t H5Aopen(hid_t obj_id, const char *attr_name, hid_t aapl_id)

Fortran90 Interface: h5aopen_f 

SUBROUTINE h5aopen_f(obj_id, attr_name, attr_id, hdferr, aapl_id) IMPLICIT NONE INTEGER(HID_T), INTENT(IN) :: obj_id ! Object identifier CHARACTER(LEN=*), INTENT(IN) :: attr_name ! Attribute name INTEGER(HID_T), INTENT(OUT) :: attr_id ! Attribute identifier INTEGER, INTENT(OUT) :: hdferr ! Error code: ! 0 on success and -1 on failure INTEGER(HID_T), OPTIONAL, INTENT(IN) :: aapl_id ! Attribute access property list END SUBROUTINE h5aopen_f

Parameters:
hid_t obj_idIN: Identifier for object to which attribute is attached; may be a file, group, dataset, or named datatype
const char * attr_name    IN: Name of attribute to open
hid_t aapl_idIN: Attribute access property list

Description:

H5A_OPEN opens an existing attribute, attr_name, that is attached to an object specified by an object identifier, obj_id.

The attribute access property list, aapl_id, is currently unused and should be H5P_DEFAULT.

This function, H5A_OPEN_BY_IDX , or H5A_OPEN_BY_NAME must be called before an attribute can be accessed for any further purpose, including reading, writing, or any modification.

The attribute identifier returned by this function must be released with H5A_CLOSE or resource leaks will develop.

Returns:

Returns an attribute identifier if successful; otherwise returns a negative value.

Example:

    file = H5Fopen (FILE, H5F_ACC_RDONLY, H5P_DEFAULT);
    dset = H5Dopen (file, DATASET, H5P_DEFAULT);
    attr = H5Aopen (dset, ATTRIBUTE, H5P_DEFAULT);

  INTEGER(HID_T)  :: file, space, dset,attr ! Handles
  INTEGER :: hdferr
  INTEGER(hsize_t),   DIMENSION(1:2) :: dims = (/dim0, dim1/)
  INTEGER, DIMENSION(1:dim0, 1:dim1), TARGET :: wdata ! Write buffer
  INTEGER, DIMENSION(:,:), ALLOCATABLE, TARGET :: rdata ! Read buffer
  INTEGER(HSIZE_T), DIMENSION(1:2) :: maxdims
  INTEGER :: i, j
  TYPE(C_PTR) :: f_ptr
  !
  ! Initialize FORTRAN interface.
  !

History:
Release    Change
1.8.0Function introduced in this release.

--- Last Modified: December 20, 2018 | 02:03 PM