External Interfaces/API Reference

mxSetM

Set the number of rows

Fortran Syntax

• subroutine mxSetM(pm, m)
  integer*4 pm, m
  

Arguments

pm
   Pointer to an mxArray.

m
   The desired number of rows.

Description

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

You can use mxSetM to change the shape of an existing mxArray. Note that mxSetM does not allocate or deallocate any space for the pr, pi, ir, or jc arrays. Consequently, if your calls to mxSetM and mxSetN 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 array, then you may want to reduce the sizes of the pr, pi, ir, and/or jc arrays in order to use heap space more efficiently.

See Also

mxGetM, mxGetN, mxSetN

mxSetLogical (Obsolete)

mxSetN