Name: H5Arename_by_name
Signature:
herr_t H5Arename_by_name( hid_t loc_id, const char *obj_name, const char *old_attr_name, const char *new_attr_name, hid_t lapl_id )

Purpose:
Renames an attribute.

Description:
H5Arename_by_name changes the name of attribute that is attached to the object specified by loc_id and obj_name. The attribute named old_attr_name is renamed new_attr_name.

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.

Parameters:
hid_t loc_id IN: Location or object identifier; may be dataset or group
const char *obj_name IN: Name of object, relative to location, whose attribute is to be renamed
const char *old_attr_name     IN: Prior attribute name
const char *new_attr_name IN: New attribute name
hid_t lapl_id IN: Link access property list identifier

Returns:
Returns a non-negative value if successful; otherwise returns a negative value.

Fortran90 Interface: h5arename_by_name_f
SUBROUTINE h5arename_by_name_f(loc_id, obj_name, old_attr_name, new_attr_name, &
     hdferr, lapl_id)
  IMPLICIT NONE
  INTEGER(HID_T), INTENT(IN) :: loc_id  ! Object identifier 
  CHARACTER(LEN=*), INTENT(IN) :: obj_name 
                                        ! Name of object, relative to location, 
                                        ! whose attribute is to be renamed
  CHARACTER(LEN=*), INTENT(IN) :: old_attr_name 
                                        ! Prior attribute name
  CHARACTER(LEN=*), INTENT(IN) :: new_attr_name 
                                        ! New attribute name
  INTEGER, INTENT(OUT) :: hdferr        ! Error code:
                                        ! 0 on success and -1 on failure
  INTEGER(HID_T), OPTIONAL, INTENT(IN) :: lapl_id 
                                        ! Link access property list identifier
END SUBROUTINE h5arename_by_name_f
    

History:
Release     C
1.8.0 Function introduced in this release.