Name: H5Aget_name
Signature:
ssize_t H5Aget_name(hid_t attr_id, size_t buf_size, char *buf )
Purpose:
Gets an attribute name.
Description:
H5Aget_name retrieves the name of an attribute specified by the identifier, attr_id. Up to buf_size characters are stored in buf followed by a \0 string terminator. If the name of the attribute is longer than (buf_size -1), the string terminator is stored in the last position of the buffer to properly terminate the string.
Parameters:
Returns:
Returns the length of the attribute's name, which may be longer than buf_size, if successful. Otherwise returns a negative value.
Fortran90 Interface: h5aget_name_f
SUBROUTINE h5aget_name_f(attr_id, size, buf, hdferr) 
  IMPLICIT NONE
  INTEGER(HID_T), INTENT(IN) :: attr_id  ! Attribute identifier 
  INTEGER, INTENT(IN) :: size            ! Buffer size 
  CHARACTER(LEN=*), INTENT(OUT) :: buf   ! Buffer to hold attribute name
  INTEGER, INTENT(OUT) :: hdferr         ! Error code: name length  
                                         ! on success and -1 on failure
END SUBROUTINE h5aget_name_f