| 外部インタフェース/API リファレンス | |
C 言語表示
#include "matrix.h" void mxSetNzmax(mxArray *array_ptr, int nzmax);
引数
array_ptr
スパースなmxArrayのポインタ。
nzmax
ir, pr, (存在すれば)piによって指し示される配列を保持するためにmxCreateSparseが割り当てる要素数。nzmaxは、mxArray内の非ゼロ要素数以上で、行数と列数の積以下の値を設定します。nzmaxの値を0と指定した場合、mxSetNzmaxはnzmaxの値を1に設定します。
詳細
mxSetNzmaxを用いて、指定したスパースなmxArrayのnzmaxフィールドに新たな値を割り当てます。nzmaxフィールドには、スパースなmxArray内の取りうる最大の非ゼロ要素数が保持されます。
ir, pr, (存在すれば)pi配列内の要素数は、nzmax.と等しくなければなりません。そのため、mxSetNzmaxを呼び出した後で、ir, pr, pi配列のサイズを変更しなければなりません。これらの配列のうちの1つのサイズを変更するには、以下のようにします。
mxCallocを呼び出し、nにnzmaxの新たな値を設定します。memcpyを呼び出し、古い配列の内容をStep 1で割り当てた新たな領域にコピーします。mxFreeを呼び出し、古い配列が占有しているメモリを開放します。mxSetルーチン(mxSetIr, mxSetPr, mxSetPi)を呼び出して、新たなメモリ領域をカレントのメモリ領域とします。
nzmaxの大きさを決定するためには、2つの方法があります。
nzmaxをスパースなmxArray内の非ゼロ要素数と等しいか、わずかに大きく設定します。この方法は、貴重なヒープ領域を保存します。nzmaxをmxArray内の要素の総数と等しくします。この方法は、メモリを浪費する再割り当てを削除(または少なくとも削減)します。例題
examplesディレクトリのmxサブディレクトリのmxsetnzmax.cを参照してください。
参考
| | mxSetName | mxSetPi | |