mxSetN (MATLAB Application Program Interface)

Set the number of columns

subroutine mxSetN(pm, n)
integer*4 pm, n

Arguments

pm
Pointer to an mxArray.

n
The desired number of columns.

Description

Call mxSetN to set the number of columns in the specified mxArray.

You typically use mxSetN to change the shape of an existing mxArray. Note that mxSetN does not allocate or deallocate any space for the pr, pi, ir, or jc arrays. Consequently, if your calls to mxSetN and mxSetM increase the number of elements in the mxArray, then you must enlarge the pr, pi, ir, and/or jc arrays.

If your calls to mxSetM and mxSetN end up reducing the number of elements in the mxArray, then you may want to reduce the size of the pr, pi, ir, or jc arrays in order to reduce heap space usage. However, reducing the size is not mandatory.