Выполните итерации по ссылкам
[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_func
H5L.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
интерпретирован можно следующим образом:
нуль | Продолжает итерацию или возвращает нулевое значение состояния вызывающей стороне, если все члены были обработаны |
положительный | Останавливает итерацию и возвращает положительное значение состояния вызывающей стороне |
отрицательный | Останавливает итерацию и выдает ошибку при указании на отказ |