This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

mxGetIr (C and Fortran)

Sparse matrix IR array

C Syntax

#include "matrix.h"
mwIndex *mxGetIr(const mxArray *pm);

Fortran Syntax

#include "fintrf.h"
mwPointer mxGetIr(pm)
mwPointer pm



Pointer to a sparse mxArray


Pointer to the first element in the ir array, if successful, and NULL in C (0 in Fortran) otherwise. Possible causes of failure include:

  • Specifying a full (nonsparse) mxArray.

  • Specifying a value for pm that is NULL in C (0 in Fortran). This failure usually means that an earlier call to mxCreateSparse failed.


Use mxGetIr to obtain the starting address of the ir array. The ir array is an array of integers. The length of ir is nzmax, the storage allocated for the sparse array, or nnz, the number of nonzero matrix elements. For example, if nzmax equals 100, the ir array contains 100 integers.

Each value in an ir array indicates a row (offset by 1) at which a nonzero element can be found. (The jc array is an index that indirectly specifies a column where nonzero elements can be found.)

For details on the ir and jc arrays, see mxSetIr and mxSetJc.


See the following examples in matlabroot/extern/examples/refbook.

See the following examples in matlabroot/extern/examples/mx.

See the following examples in matlabroot/extern/examples/mex.

Introduced before R2006a

Was this topic helpful?