External Interfaces Reference

mxCreateCellMatrix

Create unpopulated two-dimensional cell mxArray

Fortran Syntax

• integer*4 function mxCreateCellMatrix(m, n)
  integer*4 m, n
  

Arguments

m
   The desired number of rows.

n
   The desired number of columns.

Returns

A pointer to the created cell mxArray, if successful. If unsuccessful in a stand-alone (nonMEX-file) application, mxCreateCellMatrix returns 0. If unsuccessful in a MEX-file, the MEX-file terminates and control returns to the MATLAB prompt. Insufficient free heap space is the only reason for mxCreateCellMatrix to be unsuccessful.

Description

Use mxCreateCellMatrix to create an m-by-n two-dimensional cell mxArray. The created cell mxArray is unpopulated; that is, mxCreateCellMatrix initializes each cell to 0. To put data into the cells, call mxSetCell.

mxCreateCellMatrix is identical to mxCreateCellArray except that mxCreateCellMatrix can create two-dimensional mxArrays only, but mxCreateCellArray can create mxArrays having any number of dimensions greater than 1.

See Also

mxCreateCellArray

mxCreateCellArray

mxCreateCharArray

© 1994-2005 The MathWorks, Inc.