mxGetNzmax (C and Fortran)

Число элементов в IR, PR и массивах PI

Синтаксис C

#include "matrix.h"
mwSize mxGetNzmax(const mxArray *pm);

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

#include "fintrf.h"
mwSize mxGetNzmax(pm)
mwPointer pm

Аргументы

pm

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

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

Число элементов, выделенное, чтобы содержать ненулевые записи в заданном разреженном mxArray, на успехе. Возвращает неопределенное значение при ошибке. Наиболее вероятной причиной отказа является тот pm точки к полному (неразреженному) mxArray.

Описание

Использование mxGetNzmax получить значение nzmax поле . nzmax поле содержит целочисленное значение, которое показывает число элементов в ir, pr, и, если это существует, pi массивы. Значение nzmax всегда больше или равен количеству ненулевых элементов в разреженном mxArray. Кроме того, значение nzmax всегда меньше чем или равно номеру времен строк количество столбцов.

Когда вы настраиваете количество ненулевых элементов в разреженном mxArray, MATLAB часто настраивает значение nzmax поле . MATLAB настраивает nzmax сократить количество дорогостоящих перераспределений и оптимизировать его использование пространства "кучи".

Примеры

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

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

mxSetNzmax

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