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 поле. The nzmax поле содержит целое значение, которое обозначает количество элементов в ir, pr, и, если он существует, pi массивы. Значение nzmax всегда больше или равно количеству ненулевых элементов в разреженном mxArray. В сложение значение nzmax всегда меньше или равно количеству строк, умноженному на количество столбцов.

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

Примеры

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

См. также

mxSetNzmax

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