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

Число элементов в 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