Creates a region reference

Procedure:

H5R_CREATE_REGION ( loc_id, name, space_id, ref_ptr )

Signature:

<pre><code class="language-c">herr_t H5Rcreate_region ( hid_t loc_id, const char *name, hid_t space_id, H5R_ref_t *ref_ptr )</code></pre>

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

Parameters:
hid_t loc_idIN: Location identifier
const char * nameIN: Name of object
hid_t space_idIN: Dataspace identifier
H5R_ref_t *r ef_ptr

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

Description:

H5R_CREATE_REGION creates the reference, ref_ptr, pointing to the region represented by space_id within the object named name located at loc_id. The parameters loc_id and name are used to locate the object. The parameter space_id identifies the dataset region that a dataset region reference points to.

Returns:

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

Example:

Coming Soon!

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