mxDestroyArray (C)

関数 MXCREATE* によって割り当てられた動的メモリを解放

C 構文

#include "matrix.h"
void mxDestroyArray(mxArray *pm);

説明

mxDestroyArray は、以下を含む指定された mxArray のメモリの割り当てを解除します。

• mxArray の特性フィールド。サイズ (m および n) や型など

• 関連付けられているデータ配列 (スパース配列の場合は ir と jc)

• 構造体配列のフィールド

• cell 配列のセル

次の mxArray では mxDestroyArray を呼び出さないでください。

• MEX ファイルの左辺の引数で返された場合

• 関数 mxGetField または関数 mxGetFieldByNumber で返された場合

• 関数 mxGetCell で返された場合

入力引数

pm — mxArray へのポインター

mxArray *

解放する mxArray へのポインター。mxArray * として指定します。pm が NULL ポインターの場合、関数は何も行いません。

例

例を開くには、次のように入力します。

edit([fullfile(matlabroot,"extern","examples","refbook","filename")]);

ここで filename は、次のようになります。

• matrixDivide.c

• matrixDivideComplex.c

• sincall.c

例を開くには、次のように入力します。

edit([fullfile(matlabroot,"extern","examples","mex","filename")]);

ここで filename は、次のようになります。

• mexcallmatlab.c

• mexgetarray.c

例を開くには、次のように入力します。

edit([fullfile(matlabroot,"extern","examples","mx","filename")]);

ここで filename は、次のようになります。

• mxisclass.c

バージョン履歴

R2006a より前に導入

参考

mxCalloc | mxMalloc | mxFree | mexMakeArrayPersistent | mexMakeMemoryPersistent