cellfun

Примените функцию к каждой ячейке в массиве ячеек

Описание

пример

A = cellfun(func,C) применяет функциональный func к содержимому каждой ячейки массива ячеек C, одна ячейка за один раз. cellfun затем конкатенирует выходные параметры от func в выходной массив A, так, чтобы для iэлемент th C, A(i) = func(C{i}). Входной параметр func указатель на функцию к функции, которая берет один входной параметр и возвращает скаляр. Выход от func может иметь любой тип данных, пока объекты того типа могут быть конкатенированы. Массив A и массив ячеек C имейте тот же размер.

Вы не можете задать порядок в который cellfun вычисляет элементы A или используйте то, чтобы они были сделанным в каком-то конкретном порядке.

пример

A = cellfun(func,C1,...,Cn) применяет func к содержимому ячеек C1,...,Cn, так, чтобы A(i) = func(C1{i},...,Cn{i}). Функциональный func должен взять n входные параметры и возвращают скаляр. Массивы ячеек C1,...,Cn у всех должен быть тот же размер.

пример

A = cellfun(___,Name,Value) применяет func с дополнительными опциями, заданными одним или несколькими Name,Value парные аргументы. Например, чтобы возвратить выходные значения в массиве ячеек, задать 'UniformOutput',false. Можно возвратить A как массив ячеек, когда func возвращает значения, которые не могут быть конкатенированы в массив. Можно использовать Name,Value парные аргументы с входными параметрами любого из предыдущих синтаксисов.

пример

[A1,...,Am] = cellfun(___) возвращает несколько выходных массивов A1,...,Am когда func возвращает m выходные значения. func может возвратить выходные аргументы, которые имеют различные типы данных, но тип данных каждого выхода должен быть тем же каждым разом func называется. Можно использовать этот синтаксис с любым из входных параметров предыдущих синтаксисов.

Количество выходных аргументов от func не должен совпадать с количеством входных параметров, заданных C1,...,Cn.

Примеры

свернуть все

Создайте массив ячеек, который содержит числовые массивы различных размеров.

C = {1:10, [2; 4; 6], []}
C=1×3 cell array
    {[1 2 3 4 5 6 7 ... ]}    {3x1 double}    {0x0 double}

Вычислите среднее значение каждого числового массива и возвратите средние значения в массиве.

A = cellfun(@mean,C)
A = 1×3

    5.5000    4.0000       NaN

Создайте два массива ячеек, которые содержат числовые массивы различных размеров.

X = {5:5:100, 10:10:100, 20:20:100};
Y = {rand(1,20), rand(1,10), rand(1,5)};

Постройте массивы. Возвратите массив объектов линии на графике от plot функционируйте и используйте их, чтобы добавить различные маркеры в каждый набор точек данных. cellfun могут возвращаемые массивы любого типа данных, пока объекты того типа данных могут быть конкатенированы.

figure
hold on
p = cellfun(@plot,X,Y);
p(1).Marker = 'o';
p(2).Marker = '+';
p(3).Marker = 's';
hold off

Figure contains an axes object. The axes object contains 3 objects of type line.

Создайте массив ячеек, который содержит числовые массивы различных размеров.

C = {1:10, [2; 4; 6], []}
C=1×3 cell array
    {[1 2 3 4 5 6 7 ... ]}    {3x1 double}    {0x0 double}

Вычислите размеры каждого массива в C. Количество строк и столбцов - каждый в 1 3 числовых массивах.

[nrows,ncols] = cellfun(@size,C)
nrows = 1×3

     1     3     0

ncols = 1×3

    10     1     0

Можно использовать cellfun применять функции к массивам ячеек из символьных векторов и к строковым массивам. cellfun обрабатывает два вида массивов тождественно.

Создайте массив ячеек из символьных векторов, который содержит будние имена.

C = {'Monday','Tuesday','Wednesday','Thursday','Friday'}
C = 1x5 cell
    {'Monday'}    {'Tuesday'}    {'Wednesday'}    {'Thursday'}    {'Friday'}

Создайте трехбуквенные сокращения от имен с помощью cellfun функция. Задайте функцию, которая извлекает первые три символа и возвращает их как вектор символов. Чтобы возвратить сокращения в массиве ячеек, задайте 'UniformOutput',false пара "имя-значение".

A = cellfun(@(x) x(1:3),C,'UniformOutput',false)
A = 1x5 cell
    {'Mon'}    {'Tue'}    {'Wed'}    {'Thu'}    {'Fri'}

Также можно вызвать cellfun на массиве строк. Для совместимости, cellfun обработки каждый элемент массива строк, как будто это был вектор символов. Если вы задаете функцию, которая возвращает текст, то cellfun возвращает его как массив ячеек из символьных векторов, не как массив строк.

Создайте сокращения от имен в массиве строк с помощью cellfun.

str = ["Saturday","Sunday"]
str = 1x2 string
    "Saturday"    "Sunday"

B = cellfun(@(x) x(1:3),str,'UniformOutput',false)
B = 1x2 cell
    {'Sat'}    {'Sun'}

Входные параметры

свернуть все

Функция, чтобы примениться к содержимому ячеек входных массивов ячеек в виде указателя на функцию, вектора символов или строкового скаляра.

func может соответствовать больше чем одному файлу функции и поэтому может представлять набор перегруженных функций. В этих случаях, MATLAB® определяет который функция вызвать на основе класса входных параметров.

Обратная совместимость

Можно задать func как вектор символов или строковый скаляр, а не указатель на функцию, но только для ограниченного набора имен функций. func может быть: 'isempty'islogicalisrealдлинаndims, 'prodofsize'размер, или 'isclass'.

Если вы задаете имя функции, а не указатель на функцию:

  • cellfun не вызывает перегруженных версий функции.

  • size и isclass функции требуют дополнительных входных параметров к cellfun функция:

    A = cellfun('size',C,k) возвращает размер вдоль kразмерность th каждого элемента C.

    A = cellfun('isclass',C,classname) возвращает логический 1 TRUE) для каждого элемента C это совпадает с classname аргумент. Этот синтаксис возвращает логический ноль (false) для объектов, которые являются подклассом classname.

Пример: A = cellfun(@mean,C) возвращает средние значения элементов C.

Входной массив в виде массива ячеек или массива строк. Если C массив строк, затем cellfun обработки каждый элемент C как будто это был вектор символов, не строка.

Аргументы name-value

Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: A = cellfun(@mean,C,'UniformOutput',false) возвращает выходные параметры mean в массиве ячеек. Используйте 'UniformOutput',false пара "имя-значение", если C содержит числовые матрицы и mean возвращает векторы.

TRUE или FALSE в виде разделенной запятой пары, состоящей из 'UniformOutput' и любой true(1 ) или false(0 ).

Значение 'UniformOutput'

Описание

true(1 )

func должен возвратить скаляры это cellfun конкатенирует в массивы.

false(0 )

cellfun возвращает выходные параметры func в массивах ячеек. Выходные параметры func может иметь любые размеры и различные типы данных.

Функция, чтобы зафиксировать ошибки в виде разделенной запятой пары, состоящей из 'ErrorHandler' и указатель на функцию. Если func выдает ошибку, затем обработчик ошибок, заданный 'ErrorHandler' фиксирует ошибку и принимает меры, заданные в функции. Обработчик ошибок или должен выдать ошибку или возвратить то же количество выходных параметров как func. Если значение 'UniformOutput' верно, затем выходные аргументы обработчика ошибок должны быть скалярами и иметь совпадающий тип данных как выходные параметры func.

Первый входной параметр обработчика ошибок является структурой с этими полями:

  • identifier — Ошибочный идентификатор

  • message — Текст сообщения об ошибке

  • index — Линейный индекс во входные массивы, в который func выдал ошибку

Остающиеся входные параметры к обработчику ошибок являются входными параметрами для вызова func это сделало func выдайте ошибку.

Предположим func возвращается два, удваивается как выходные аргументы. Можно задать обработчик ошибок как 'ErrorHandler',@errorFunc, где errorFunc функция, которая повышает предупреждение и возвращает два выходных аргумента.

function [A,B] = errorFunc(S,varargin)
    warning(S.identifier, S.message); 
    A = NaN; 
    B = NaN;
end

Если вы не задаете 'ErrorHandler'то cellfun повторно выдает ошибку, выданную func.

Выходные аргументы

свернуть все

Выходной массив, возвращенный как массив любого типа данных или как массив ячеек.

По умолчанию, cellfun конкатенирует выходные параметры от func в массив. func должен возвратить скаляры. Если func возвращает объекты, затем класс, которому принадлежат объекты, должен удовлетворить эти требования.

  • Поддержите присвоение линейной индексацией в объектный массив

  • Имейте a reshape метод, который возвращает массив, который имеет тот же размер как вход

Если значение 'UniformOutput' аргументом пары "имя-значение" является false(0 то cellfun возвращает выходные параметры в массиве ячеек. В этом случае, выходные параметры от func может иметь любые размеры и различные типы данных.

Расширенные возможности

Представлено до R2006a