mxCreateCharArray (外部インタフェース/API リファレンス)

要素の入っていないN次元の文字列のmxArrayを作成

C 言語表示

#include "matrix.h"
mxArray *mxCreateCharArray(int ndim, const int *dims);

引数
ndim
文字列mxArray内の希望する次元数。正の数値を指定する必要があります。0, 1, 2 を指定した場合は、mxCreateCharArrayは2次元のmxArrayを作成します。

dims

次元配列。次元配列の各要素には、その次元の配列のサイズが含まれます。たとえば、dims[0]を5に、dims[1]を7に設定すると、5行7列のmxArrayを作成します。配列dimsは、少なくともndim要素をもたなければなりません。

戻り値

成功した場合は、作成した文字列mxArrayのポインタ。スタンドアロン(非MEX-ファイル)アプリケーションで成功しない場合は、mxCreateCharArrayはNULLを出力します。MEX-ファイルで成功しない場合は、MEX-ファイルは終了し、制御はMATLABプロンプトに戻ります。mxCreateCharArrayが成功しない唯一の理由は、フリーなヒープ領域が不十分であることです。

詳細

mxCreateCharArrayを呼び出すことによって、空のN次元の文字列mxArrayを作成します。

例題

examplesディレクトリのmxサブディレクトリのmxcreatecharmatrixfromstr.cを参照してください。

参考

mxCreateCharMatrixFromStrings, mxCreateString

mxCreateCellMatrix mxCreateCharMatrixFromStrings