exponenta event banner

mxGetNzmax (C и Fortran)

Количество элементов в массивах ИК, 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