Routines (alphabetical) > Routines: H > HDF5 Routines > H5R_GET_REGION

# H5R_GET_REGION

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