Выполните итерации через ссылки в группе, заданной по наименованию
[status,idx_out,opdata_out] = H5L.iterate_by_name(loc_id,group_name,index_type,order,idx_in,iter_func,opdata_in,lapl_id)
[status,idx_out,opdata_out] = H5L.iterate_by_name(loc_id,group_name,index_type,order,idx_in,iter_func,opdata_in,lapl_id) выполняет итерации через ссылки в группе, чтобы выполнить общую функцию, указателем на функцию которой является iter_func. Начальная точка итерации соединяется заданного ID местоположения и относительным названием группы. H5L.iterate_by_name рекурсивно не переходит по ссылкам в подгруппы заданной группы. Список свойств доступа к ссылке, lapl_id, может влиять на результат в зависимости от типа пересекаемой ссылки.
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 интерпретирован можно следующим образом:
| нуль | Продолжает итерацию или возвращает нулевое значение состояния вызывающей стороне, если все члены были обработаны |
| положительный | Останавливает итерацию и возвращает положительное значение состояния вызывающей стороне |
| отрицательный | Останавливает итерацию и выдает ошибку при указании на отказ |