MATLAB Application Program Interface Reference

Create an unpopulated 2-dimensional mxArray

integer*4 function mxCreateFull(m, n, ComplexFlag)
integer*4 m, n, ComplexFlag

Arguments

The desired number of rows.

The desired number of columns.

ComplexFlag

Specify REAL = 0 if the data has no imaginary components; specify
COMPLEX = 1 if the data has some imaginary components.

Returns

An unpopulated, m-by-n mxArray if successful, 0 otherwise.

Description

Use mxCreateFull to create an unpopulated mxArray of size m-by-n. mxCreateFull initializes each element in the pr array to 0. If you set ComplexFlag to 1, mxCreateFull also initializes each element in the pi array to 0.

If you specify REAL = 0, mxCreateFull allocates enough memory to hold m-by-n real elements. If you specify COMPLEX = 1, mxCreateFull allocates enough memory to hold m-by-n real elements and m-by-n imaginary elements.

Call mxFreeMatrix when you finish using the mxArray. mxFreeMatrix deallocates the mxArray and its associated real and complex elements.