mxGetIr (C и Фортран)

Массив ir разреженной матрицы

Синтаксис C

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

Синтаксис языка ФОРТРАН

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

Аргументы

pm

Указатель на разреженный mxArray

Возвращается

Указатель на первый элемент в массиве ir, в случае успеха, и NULL в C (0 на Фортране) в противном случае. Возможные причины отказа включают:

  • Определение полного (неразреженного) mxArray.

  • Определение значения для pm, который является NULL в C (0 на Фортране). Этот отказ обычно означает что более ранний вызов отказавшего mxCreateSparse.

Описание

Используйте mxGetIr, чтобы получить начальный адрес массива ir. Массив ir является массивом целых чисел. Длиной ir является nzmax, устройство хранения данных, выделенное для разреженного массива, или nnz, количества ненулевых элементов матрицы. Например, если nzmax равняется 100, то массив ir содержит 100 целых чисел.

Каждое значение в массиве ir указывает на строку (смещенный 1), в котором может быть найден ненулевой элемент. (Массив jc является индексом, который косвенно задает столбец, где ненулевые элементы могут быть найдены.)

Для получения дополнительной информации на ir и массивах jc, смотрите mxSetIr и mxSetJc.

Примеры

Смотрите эти примеры в matlabroot/extern/examples/refbook:

Смотрите эти примеры в matlabroot/extern/examples/mx:

Смотрите эти примеры в matlabroot/extern/examples/mex:

Смотрите также

mxGetJc, mxGetNzmax, mxSetIr, mxSetJc, mxSetNzmax, nzmax, nnz

Представлено до R2006a