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.