H5L.iterate

Выполните итерации по ссылкам

Синтаксис

[status,idx_out,opdata_out] = H5L.iterate(group_id,index_type,order,idx_in,iter_func,opdata_in)

Описание

[status,idx_out,opdata_out] = H5L.iterate(group_id,index_type,order,idx_in,iter_func,opdata_in) выполняет итерации через ссылки в группе, заданной group_id, выполнять общую функцию, указателем на функцию которой является iter_funcH5L.iterate рекурсивно не переходит по ссылкам в подгруппы заданной группы.

index_type и order установите итерацию. index_type задает индекс, который будет использоваться. Если ссылки не были индексированы типом индекса, они будут сначала отсортированы по тому индексу затем, итерация начнется. Если ссылки были так индексированы, шаг сортировки будет ненужным, таким образом, итерация сможет начаться более быстро. Задайте index_type как один из этих векторов символов или строковых скаляров.

'H5_INDEX_NAME'Алфавитно-цифровой индекс на имени
'H5_INDEX_CRT_ORDER'Индексируйте на порядке создания

order задает порядок, в котором объекты состоят в том, чтобы смотреться вдоль индекса, заданного в index_type. Задайте order как один из этих векторов символов или строковых скаляров.

'H5_ITER_INC'Увеличение порядка
'H5_ITER_DEC'Уменьшение порядка
'H5_ITER_NATIVE'Самый быстрый доступный порядок

idx_in задает начальную точку итерации. idx_out возвращает точку, в которой была остановлена итерация. Это позволяет прерванной итерации быть возобновленной.

Функция обратного вызова iter_func должен иметь следующую подпись:

function [status,opdata_out] = iter_func(group_id,name,opdata_in)

opdata_in пользовательское значение или структура и передается первому шагу итерации в iter_func opdata_in параметр. opdata_out из итерации шаг формирует opdata_in для следующего шага итерации. Итоговый opdata_out в конце итерации затем возвращен в вызывающую сторону как opdata_out.

status значение возвращено iter_func интерпретирован можно следующим образом:

нульПродолжает итерацию или возвращает нулевое значение состояния вызывающей стороне, если все члены были обработаны
положительныйОстанавливает итерацию и возвращает положительное значение состояния вызывающей стороне
отрицательныйОстанавливает итерацию и выдает ошибку при указании на отказ