Итерация по масштабам, присоединенным к размеру набора данных
[status,idx_out,opdata_out] = H5DS.iterate_scales(dset_id,dim,idx_in,iter_func,opdata_in)
[status,idx_out,opdata_out] = H5DS.iterate_scales(dset_id,dim,idx_in,iter_func,opdata_in) итерации по масштабам, присоединенным к размеру dim набора данных dset_id для выполнения общей операции с дескриптором функции iter_func.
idx_in указывает начальную точку итерации. idx_out возвращает точку, в которой была остановлена итерация. Это позволяет возобновить прерванную итерацию. Если idx_in является [], то итератор начинается с первого элемента.
Функция обратного вызова iter_func должна иметь следующую подпись:
function [status,opdata_out] = iter_func(dset_id,dim,dimscale_id,opdata_in)
opdata_in является пользовательским значением или структурой и передается на первый шаг итерации в iter_func opdata_in параметр. opdata_out этапа итерации формирует opdata_in для следующего шага итерации. Финал opdata_out в конце итерации возвращается вызывающему абоненту как opdata_out.
dimscale_id указывает идентификатор текущего набора данных размерного масштаба и dim - связанное измерение.
значение состояния, возвращенное iter_func интерпретируется следующим образом:
| ноль | Продолжение итерации или возврат нулевого значения состояния вызывающему абоненту, если все элементы обработаны |
| положительный | Останавливает итерацию и возвращает вызывающей стороне положительное значение состояния |
| отрицательный | Останавливает итерацию и выдает ошибку, указывающую на сбой |