- Created by Barbara Jones, last modified on Dec 20, 2018
Jump to ...
Switch language ...
Opens the nth attribute attached to an object
H5A_OPEN_BY_IDX(loc_id, obj_name, idx_type, order, n, aapl_id, lapl_id)
hid_t H5Aopen_by_idx ( hid_t loc_id, const char *obj_name, H5_index_t idx_type, H5_iter_order_t order, hsize_t n, hid_t aapl_id, hid_t lapl_id )
SUBROUTINE h5aopen_by_idx_f(loc_id, obj_name, idx_type, order, n, attr_id, & hdferr, aapl_id, lapl_id) IMPLICIT NONE INTEGER(HID_T), INTENT(IN) :: loc_id ! Object identifier CHARACTER(LEN=*), INTENT(IN) :: obj_name ! Name of object to which attribute is attached INTEGER, INTENT(IN) :: idx_type ! Type of index; Possible values are: ! H5_INDEX_UNKNOWN_F - Unknown index type ! H5_INDEX_NAME_F - Index on names ! H5_INDEX_CRT_ORDER_F - Index on creation order ! H5_INDEX_N_F - Number of indices defined INTEGER, INTENT(IN) :: order ! Order in which to iterate over index: ! H5_ITER_UNKNOWN_F - Unknown order ! H5_ITER_INC_F - Increasing order ! H5_ITER_DEC_F - Decreasing order ! H5_ITER_NATIVE_F - No particular order, ! whatever is fastest INTEGER(HSIZE_T), INTENT(IN) :: n ! Attribute’s position in index 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 INTEGER(HID_T), OPTIONAL, INTENT(IN) :: lapl_id ! Link access property list END SUBROUTINE h5aopen_by_idx_f
|hid_t ||IN: Location identifier of object to which attribute is attached; may be a file, group, dataset, or named datatype|
|const char * ||IN: Name of object to which attribute is attached, relative to location|
|H5_index_t ||IN: Type of index|
|H5_iter_order_t ||IN: Index traversal order|
|hsize_t ||IN: Attribute’s position in index|
|hid_t ||IN: Attribute access property list|
|hid_t ||IN: Link access property list|
H5A_OPEN_BY_IDX opens an existing attribute that is attached to an object specified by location and name,
obj_name , respectively. If
loc_id fully specifies the object to which the attribute is attached,
obj_name should be
'.' (a dot).
The attribute is identified by an index type, an index traversal order, and a position in the index,
n, respectively. These parameters and their valid values are discussed in the description of H5A_ITERATE2.
The attribute access property list,
aapl_id, is currently unused and should currently be
The link access property list,
lapl_id, may provide information regarding the properties of links required to access the object,
obj_name. See “Link Access Properties” in the H5P APIs.
This function, H5A_OPEN , 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 an attribute identifier if successful; otherwise returns a negative value.
|1.8.0||Function introduced in this release.|
--- Last Modified: December 20, 2018 | 02:03 PM