Рекурсивная итерация через ссылки в группе, заданной идентификатором группы
[status opdata_out] = H5L.visit(group_id,index_type,order,iter_func,opdata_in)
[status opdata_out] = H5L.visit(group_id,index_type,order,iter_func,opdata_in)
рекурсивно итерация через все ссылки в группе и ниже, заданная group_id
, для выполнения общей функции, указатель на функцию которой iter_func
.
index_type
и порядок установления итерации. index_type
задает используемый индекс. Если ссылки не были индексированы по типу индекса, они сначала сортируются по этому индексу, а затем начинается итерация. Если ссылки были так индексированы, шаг сортировки не нужен, поэтому итерация может начаться быстрее. Задайте index_type
как один из этих векторов символов или строковых скаляров.
'H5_INDEX_NAME' | Альфа-числовой индекс по имени |
'H5_INDEX_CRT_ORDER' | Индекс по порядку создания |
Обратите внимание, что тип индекса прошел в index_type
является наилучшей настройкой усилий. Если приложение передает значение, указывающее итерацию в порядке создания и обнаруживается группа, которая не отслеживалась в порядке создания, эта группа будет итерация в альфа-числовом порядке по наименованию или порядку имен. (Порядок имен является собственным порядком, используемым библиотекой HDF5, и всегда доступен.)
order
задает порядок проверки объектов по индексу, указанному в index_type
. Задайте order
как один из этих векторов символов или строковых скаляров.
'H5_ITER_INC' | Порядок возрастания |
'H5_ITER_DEC' | Уменьшение порядка |
'H5_ITER_NATIVE' | Самый быстрый доступный порядок |
Функция обратного вызова 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
интерпретируется следующим образом.
нуль | Продолжается с итерацией или возвращает нулевое значение состояния вызывающему абоненту, если все представители были обработаны |
положительный | Останавливает итерацию и возвращает положительное значение состояния вызывающему абоненту |
отрицательный | Останавливает итерацию и выдает ошибку, указывающую на отказ |