H5LRcreate_ref_to_all creates a dataset with the region references to the data in all datasets located under a specified group in a file or creates a dataset with object references to all objects (groups or datasets) located under a specified group in a file.
Given a dataset path ds_path in a file specified by the loc_id identifier, the function H5LRcreate_ref_to_all will create a contiguous one-dimensional dataset with the region references or object references depending on the value of the ref_type parameter. When ref_type is H5R_DATASET_REGION, each region reference points to all data in a dataset encountered by an internally called H5Lvisit routine, which starts at the group specified by the loc_id and group_path parameters. In a like manner, when ref_type is H5R_OBJECT, each object reference points to an object (a group or a dataset) encountered by H5Lvisit.
If ds_path does not exist in loc_id then the function will create the path specified by ds_path automatically.
index_type specifies the index to be used. Valid values include the following:
H5_INDEX_NAME Alpha-numeric index on name
H5_INDEX_CRT_ORDER Index on creation order
order specifies the order in which objects are to be inspected along the index specified in index_type. Valid values include the following:
H5_ITER_INC Increasing order
H5_ITER_DEC Decreasing order
H5_ITER_NATIVE Fastest available order
For more detailed information on these two parameters, see H5Lvisit.
ref_type specifies the type of the reference to be used. Valid values include the following:
H5R_DATASEY_REGION Dataset region reference
H5R_OBJECT Object reference