Retrieves the attribute name for a referenced object


H5R_GET_ATTR_NAME ( ref_ptr, name, size )


<pre><code class="language-c">ssize_t H5Rget_attr_name ( const H5R_ref_t *ref_ptr, char *name, size_t size )</code></pre>

<pre><code class="language-fortran">Replace this text with the Fortran function signature</code></pre>

const H5R_ref_ * ref_ptr

IN: Pointer to reference to query
H5R_ref_t is defined in H5Rpublic.h as:   typedef unsigned char H5R_ref_t[H5R_REF_BUF_SIZE];

char * nameIN/OUT: A buffer to place the attribute name of the reference
size_t sizeIN: The size of the name buffer


H5R_GET_ATTR_NAME retrieves the attribute name for the attribute reference pointed to by ref_ptr. Up to size characters of the name are returned in name; additional characters, if any, are not returned to the user application. If the length of the name, which determines the required value of size, is unknown, a preliminary H5R_GET_ATTR_NAME call can be made. The return value of this call will be the size of the attribute name. That value can then be assigned to size for a second H5R_GET_ATTR_NAME call, which will retrieve the actual name.


Returns the length of the name if successful. Otherwise returns a negative value.



1.12.0C function was introduced in this release.