mxCreateUninitNumericMatrix (C)

初期化されない 2 次元数値行列

C 構文

#include "matrix.h"
mxArray *mxCreateUninitNumericMatrix(size_t m, size_t n, 
  mxClassID classid, mxComplexity ComplexFlag);

引数

m

行数

n

列数

classid

メモリで数値データを表す方法を決定する、配列のクラスの識別子。たとえば、mxINT16_CLASS を指定すると、mxArray 内の数値データの各数値が 16 ビットの符号付き整数として表されます。

ComplexFlag

作成する mxArray に虚数データを含める場合、ComplexFlag を mxCOMPLEX に設定します。そうでない場合は、ComplexFlag を mxREAL に設定します。

戻り値

成功した場合は、作成された mxArray へのポインター。スタンドアロン (非 MEX ファイル) アプリケーションで失敗した場合、NULL を返します。MEX ファイルで失敗した場合、MEX ファイルは終了し、制御が MATLAB^® プロンプトに戻ります。関数は、mxArray を作成するのに十分な空きヒープ領域がない場合、失敗します。

例

matlabroot/extern/examples/mx の次の例を参照してください。

• mxcreateuninitnumericmatrix.c

説明

mxCreateUninitNumericMatrix を呼び出して、2 次元の mxArray を作成します。ここで、すべてのデータ要素は classid で指定される数値データ型をもちます。データ要素は初期化されません。

mxCreateUninitNumericMatrix は、作成した mxArray を格納するための動的メモリを割り当てます。mxDestroyArray を呼び出してメモリの割り当てを解除します。

次の表は、MATLAB クラスに相当する C の classid 値を示します。

MATLAB クラス名	C の classid 値
int8	mxINT8_CLASS
uint8	mxUINT8_CLASS
int16	mxINT16_CLASS
uint16	mxUINT16_CLASS
int32	mxINT32_CLASS
uint32	mxUINT32_CLASS
int64	mxINT64_CLASS
uint64	mxUINT64_CLASS
single	mxSINGLE_CLASS
double	mxDOUBLE_CLASS

参考

mxDestroyArray, mxCreateUninitNumericArray, mxCreateNumericMatrix

バージョン履歴

R2015a で導入