- Created by Barbara Jones, last modified on Dec 20, 2018
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_id | IN: 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_id | IN: 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.0 | Function introduced in this release. |
--- Last Modified: December 20, 2018 | 02:03 PM