Uninitialized 2-D numeric matrix
#include "matrix.h" mxArray *mxCreateUninitNumericMatrix(size_t m, size_t n, mxClassID classid, mxComplexity ComplexFlag);
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
.
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
.
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 |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|