H5L.visit

Рекурсивно выполните итерации через ссылки в группе, заданной идентификатором группы

Синтаксис

[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 параметр. opdata_out из итерации шаг формирует opdata_in для следующего шага итерации. Итоговый opdata_out в конце итерации затем возвращен в вызывающую сторону как opdata_out.

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

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