structfun
Применить функцию к каждому полю скалярной структуры
Описание
A = structfun(func,S)func к каждому полю скалярной структуры S, по одному полю за раз. structfun затем конкатенирует выходы func в вектор-столбец A. Входной параметр func - указатель на функцию функции, который принимает один входной параметр и возвращает скаляр. Выходы func может иметь любой тип данных, при условии, что объекты этого типа могут быть объединены. Количество элементов в A равен количеству полей в S.
Вы не можете задать порядок, в котором structfun вычисляет элементы A или полагаться на то, что они выполняются в любом конкретном порядке.
A = structfun(func,S,Name,Value)func с дополнительными опциями, заданными одним или несколькими Name,Value аргументы в виде пар. Для примера, чтобы вернуть выход значения в структуре, задайте 'UniformOutput',false. Можно вернуться A как структура, когда func возвращает значения, которые нельзя объединить в массив. Возвращенная структура имеет те же поля, что и S.
[A1,...,Am] = structfun(___) возвращает несколько выходных массивов A1,...,Am когда func возвращает m выходные значения. func могут возвращать выходные аргументы, которые имеют различные типы данных, но тип данных каждого выхода должен быть одинаковым каждый раз func вызывается. Можно использовать этот синтаксис с любым из входных параметров предыдущих синтаксисов.
Примеры
Применить функцию к полям структуры
Создайте скалярную структуру с полями, которые содержат числовые массивы разных размеров.
S.f1 = 1:10; S.f2 = [2; 4; 6]; S.f3 = []
S = struct with fields:
f1: [1 2 3 4 5 6 7 8 9 10]
f2: [3x1 double]
f3: []
Вычислите среднее значение каждого числового массива и верните средство в массиве.
A = structfun(@mean,S)
A = 3×1
5.5000
4.0000
NaN
Возврат объектного массива
Создайте скалярную структуру, в которой каждое поле содержит массив случайных чисел.
S.X = rand(1,10); S.Y = rand(1,10); S.Z = rand(1,10)
S = struct with fields:
X: [0.8147 0.9058 0.1270 0.9134 0.6324 0.0975 0.2785 0.5469 0.9575 0.9649]
Y: [0.1576 0.9706 0.9572 0.4854 0.8003 0.1419 0.4218 0.9157 0.7922 0.9595]
Z: [0.6557 0.0357 0.8491 0.9340 0.6787 0.7577 0.7431 0.3922 0.6555 0.1712]
Постройте график массивов. Верните массив объектов линий на графике из plot и используйте их, чтобы добавить различные маркеры к каждому набору точек данных. structfun можно возвращать массивы любого типа данных, при условии, что объекты этого типа данных могут быть объединены.
figure hold on p = structfun(@plot,S); p(1).Marker = 'o'; p(2).Marker = '+'; p(3).Marker = 's'; hold off
Возврат скалярной структуры
Создайте скалярную структуру с полями, которые содержат матрицы.
S.f1 = 1:10; S.f2 = [2 3; 4 5; 6 7]; S.f3 = rand(4,4)
S = struct with fields:
f1: [1 2 3 4 5 6 7 8 9 10]
f2: [3x2 double]
f3: [4x4 double]
Вычислим средства каждой матрицы. mean возвращает векторы, содержащие среднее значение каждого столбца, поэтому средство не может быть возвращено как массив. Чтобы вернуть средства в структуре, задайте 'UniformOutput',false Пара "имя-значение".
A = structfun(@mean,S,'UniformOutput',false)A = struct with fields:
f1: 5.5000
f2: [4 5]
f3: [0.6902 0.3888 0.7627 0.5962]
Возврат нескольких выходных массивов
Создайте скалярную структуру.
S.f1 = 1:10; S.f2 = [2 3; 4 5; 6 7]; S.f3 = rand(4,4)
S = struct with fields:
f1: [1 2 3 4 5 6 7 8 9 10]
f2: [3x2 double]
f3: [4x4 double]
Вычислите размеры каждого массива в S. Количество строк и столбцов в числовых массивах 3 на 1.
[nrows,ncols] = structfun(@size,S)
nrows = 3×1
1
3
4
ncols = 3×1
10
2
4
Входные параметры
Выходные аргументы
Расширенные возможности
См. также
arrayfun | cell2mat | cellfun | spfun | splitapply