The H5R_GET_REGION function retrieves a dataspace associated with a region reference.

Example


Assuming the file, 'hdf5_out.h5' was created using the example in H5F_CREATE, the dataspace region saved in the reference attached to the “Hanning” dataset could be obtained as follows:

fid = H5F_OPEN('hdf5_out.h5')
dataset_id = H5D_OPEN(fid,'Hanning')
attr_id = H5A_OPEN_NAME(dataset_id,'Ref')
ref = H5A_READ(attr_id)
dataspace_id = H5R_GET_REGION(dataset_id,ref)

Syntax


Result = H5R_GET_REGION(Dataset_id, Reference)

Return Value


The Result gives the identifier of the dataspace with the region selected.

Arguments


Dataset_id

An integer giving the identifier in which the reference dataset is located.

Reference

An H5 reference structure giving the reference number to open.

Keywords


None

Version History


6.2

Introduced

See Also


H5R_CREATE, H5D_CREATE, H5D_CLOSE