External Interfaces Reference |
Create unpopulated two-dimensional, double-precision, floating-point mxArray
C Syntax
Arguments
n
The desired number of columns.
ComplexFlag
Specify either mxREAL
or mxCOMPLEX
. If the data you plan to put into the mxArray
has no imaginary components, specify mxREAL
. If the data has some imaginary components, specify mxCOMPLEX
.
Returns
A pointer to the created mxArray
, if successful. If unsuccessful in a stand-alone (nonMEX-file) application, mxCreateDoubleMatrix
returns NULL
. If unsuccessful in a MEX-file, the MEX-file terminates and control returns to the MATLAB prompt. mxCreateDoubleMatrix
is unsuccessful when there is not enough free heap space to create the mxArray
.
Description
Use mxCreateDoubleMatrix
to create an m
-by-n
mxArray
. mxCreateDoubleMatrix
initializes each element in the pr
array to 0. If you set ComplexFlag
to mxCOMPLEX
, mxCreateDoubleMatrix
also initializes each element in the pi
array to 0.
If you set ComplexFlag
to mxREAL
, mxCreateDoubleMatrix
allocates enough memory to hold m
-by-n
real elements. If you set ComplexFlag
to mxCOMPLEX
, mxCreateDoubleMatrix
allocates enough memory to hold m
-by-n
real elements and m
-by-n
imaginary elements.
Call mxDestroyArray
when you finish using the mxArray
. mxDestroyArray
deallocates the mxArray
and its associated real and complex elements.
Examples
See convec.c
, findnz.c
, sincall.c
, timestwo.c
, timestwoalt.c
, and xtimesy.c
in the refbook
subdirectory of the examples
directory.
See Also
mxCreateNumericArray
, mxComplexity
mxCreateCharMatrixFromStrings | mxCreateDoubleScalar |
© 1994-2005 The MathWorks, Inc.