External Interfaces Reference |
Create unpopulated N-dimensional cell mxArray
Fortran Syntax
Arguments
ndim
The desired number of dimensions in the created cell. For example, to create a three-dimensional cell mxArray
, set ndim
to 3
.
dims
The dimensions array. Each element in the dimensions array contains the size of the mxArray
in that dimension. For example, setting dims(1)
to 5
and dims(2)
to 7
establishes a 5-by-7 mxArray
. In most cases, there should be ndim
elements in the dims
array.
Returns
A pointer to the created cell mxArray
, if successful. If unsuccessful in a stand-alone (nonMEX-file) application, mxCreateCellArray
returns 0
. If unsuccessful in a MEX-file, the MEX-file terminates and control returns to the MATLAB prompt. The most common cause of failure is insufficient free heap space.
Description
Use mxCreateCellArray
to create a cell mxArray
whose size is defined by ndim
and dims
. For example, to establish a three-dimensional cell mxArray
having dimensions 4-by-8-by-7, set
The created cell mxArray
is unpopulated; that is, mxCreateCellArray
initializes each cell to 0
. To put data into a cell, call mxSetCell
.
Any trailing singleton dimensions specified in the dims
argument are automatically removed from the resulting array. For example, if ndim
equals 5
and dims
equals [4 1 7 1 1]
, the resulting array is given the dimensions 4-by-1-by-7.
See Also
mxCreateCellMatrix
, mxGetCell
, mxSetCell
, mxIsCell
mxCopyReal8ToPtr | mxCreateCellMatrix |
© 1994-2005 The MathWorks, Inc.