Copies an existing reference

Procedure:

H5R_COPY ( src_ref_ptr, dst_ref_ptr )

Signature:

<pre><code class="language-c">herr_t H5Rcopy ( const H5R_ref_t *src_ref_ptr, H5R_ref_t *dst_ref_ptr )</code></pre>

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

Parameters:
const H5R_ref_t * src_ref_ptr

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

H5R_ref_t * dst_ref_ptr

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

Description:

H5R_COPY creates a copy of an existing reference. src_ref_ptr points to the reference to copy and dst_ref_ptr is the pointer to the destination reference.

Returns:

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

Example:

History:
ReleaseChange
1.12.0C function was introduced in this release.