mxCreateUninitNumericMatrix (C)

C Syntax

#include "matrix.h"
mxArray *mxCreateUninitNumericMatrix(size_t m, size_t n, 
  mxClassID classid, mxComplexity ComplexFlag);

Arguments

m: Number of rows
n: Number of columns
classid: Identifier for the class of the array, which determines the way the numerical data is represented in memory. For example, specifying mxINT16_CLASS causes each piece of numerical data in the mxArray to be represented as a 16-bit signed integer.
ComplexFlag: If the mxArray you are creating is to contain imaginary data, set ComplexFlag to mxCOMPLEX. Otherwise, set ComplexFlag to mxREAL.

Returns

Pointer to the created mxArray, if successful. If unsuccessful in a standalone (non-MEX-file) application, returns NULL. If unsuccessful in a MEX-file, the MEX-file terminates and returns control to the MATLAB^® prompt. The function is unsuccessful when there is not enough free heap space to create the mxArray.

Example

See these examples in matlabroot/extern/examples/mx:

mxcreateuninitnumericmatrix.c

Description

Call mxCreateUninitNumericMatrix to create a 2-D mxArray in which all data elements have the numeric data type specified by classid. Data elements are not initialized.

mxCreateUninitNumericMatrix allocates dynamic memory to store the created mxArray. Call mxDestroyArray to deallocate the memory.

The following table shows the C classid values that are equivalent to MATLAB classes.

MATLAB Class Name	C `classid` Value
`int8`	`mxINT8_CLASS`
`uint8`	`mxUINT8_CLASS`
`int16`	`mxINT16_CLASS`
`uint16`	`mxUINT16_CLASS`
`int32`	`mxINT32_CLASS`
`uint32`	`mxUINT32_CLASS`
`int64`	`mxINT64_CLASS`
`uint64`	`mxUINT64_CLASS`
`single`	`mxSINGLE_CLASS`
`double`	`mxDOUBLE_CLASS`