This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

H5O.open_by_idx

Open object specified by index

Syntax

obj_id = H5O.open_by_idx(loc_id, group_name, idx_type, order, n, lapl_id)

Description

obj_id = H5O.open_by_idx(loc_id, group_name, idx_type, order, n, lapl_id) opens the n-th object in the group specified by loc_id and group_name. loc_id specifies a file or group. group_name specifies the group relative to loc_id in which the object can be found.

Two parameters are used to establish the iteration: index_type and order. index_type specifies the type of index by which objects are ordered. Specify index_type as one of these character vectors or string scalars.

'H5_INDEX_NAME'Alpha-numeric index on name
'H5_INDEX_CRT_ORDER'Index on creation order

order specifies the order in which the links are to be referenced for the purposes of this function. Specify order as one of these character vectors or string scalars.

'H5_ITER_INC'Increasing order
'H5_ITER_DEC'Decreasing order
'H5_ITER_NATIVE'Fastest available order

n specifies the zero-based position of the object within the index. lapl_id specifies the link access property list to be used in accessing the object.

Examples

fid = H5F.open('example.h5');
idx_type = 'H5_INDEX_NAME';
order = 'H5_ITER_DEC';
obj_id = H5O.open_by_idx(fid,'g3',idx_type,order,0,'H5P_DEFAULT');
H5O.close(obj_id);
H5F.close(fid);