H5L.iterate

Выполните итерации по ссылкам

Синтаксис

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

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

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