Documentation Center

  • Trial Software
  • Product Updates

mxCreateSparseLogicalMatrix (C)

2-D, sparse, logical array

C Syntax

#include "matrix.h"
mxArray *mxCreateSparseLogicalMatrix(mwSize m, mwSize n, 
  mwSize nzmax);



Number of rows


Number of columns


Number of elements that mxCreateSparseLogicalMatrix should allocate to hold the data. Set the value of nzmax to be greater than or equal to the number of nonzero elements you plan to put into the mxArray, but make sure that nzmax is less than or equal to m*n.


Pointer to the created mxArray, if successful. If unsuccessful in a standalone (non-MEX-file) application, returns NULL in C (0 in Fortran). 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.


Use mxCreateSparseLogicalMatrix to create an m-by-n mxArray of mxLogical elements. mxCreateSparseLogicalMatrix initializes each element in the array to logical 0.

Call mxDestroyArray when you finish using the mxArray. mxDestroyArray deallocates the mxArray and its elements.

Was this topic helpful?