Renames an attribute

Procedure:

H5A_RENAME(loc_id, old_attr_name, new_attr_name)

Signature:

<pre><code class="language-c">herr_t H5Arename
(
    hid_t loc_id,
    char *old_attr_name,
    char *new_attr_name
)</code></pre>

<pre><code class="language-fortran">SUBROUTINE h5arename_f(loc_id, old_attr_name, new_attr_name, hdferr) 
    IMPLICIT NONE
    INTEGER(HID_T), INTENT(IN) :: loc_id          ! Object identifier
    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, -1 on failure
END SUBROUTINE h5arename_f</code></pre>

Parameters:
hid_t loc_idIN: Location identifier of the attribute; may be a file, group, dataset or named datatype
char * old_attr_name    IN: Name of the attribute to be changed
char * new_attr_nameIN: New name for the attribute

Description:

H5A_RENAME  changes the name of the attribute located at  loc_id .

The old name, old_attr_name, is changed to the new name, new_attr_name.

Returns:

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

Example:

Coming Soon!