MATLAB Function Reference

cellfun

Apply a function to each element in a cell array

Syntax

• D = cellfun('fname',C)
  D = cellfun('size',C,k)
  D = cellfun('isclass',C,classname)
  

Description

D = cellfun('fname',C) applies the function fname to the elements of the cell array C and returns the results in the double array D. Each element of D contains the value returned by fname for the corresponding element in C. The output array D is the same size as the cell array C.

These functions are supported:

Function	Return Value
isempty	true for an empty cell element
islogical	true for a logical cell element
isreal	true for a real cell element
length	Length of the cell element
ndims	Number of dimensions of the cell element
prodofsize	Number of elements in the cell element

D = cellfun('size',C,k) returns the size along the k-th dimension of each element of C.

D = cellfun('isclass',C,'classname') returns true for each element of C that matches classname. This function syntax returns false for objects that are a subclass of classname.

Limitations

If the cell array contains objects, cellfun does not call overloaded versions of the function fname.

Example

Consider this 2-by-3 cell array:

• C{1,1} = [1 2; 4 5]; 
  C{1,2} = 'Name';
  C{1,3} = pi;
  C{2,1} = 2 + 4i; 
  C{2,2} = 7;
  C{2,3} = magic(3);
  

cellfun returns a 2-by-3 double array:

• D = cellfun('isreal',C)
  
  D =
       1     1     1
       0     1     1
  
  len = cellfun('length',C)
  
  len =
       2     4     1
       1     1     3
  
  isdbl = cellfun('isclass',C,'double')
  
  isdbl =
       1     0     1
       1     1     1
  

See Also

isempty, islogical, isreal, length, ndims, size

celldisp

cellplot