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