mxCreateCharMatrixFromStrings (C)

指定値に初期化された 2 次元の mxChar 配列

C 構文

#include "matrix.h"
mxArray *mxCreateCharMatrixFromStrings(mwSize m, const char **str);

説明

mxCreateCharMatrixFromStrings を使用して、2 次元の mxArray を作成します。ここで、各行は str からの string に初期化されます。mxArray は m 行 max 列の次元になります。ここで max は、str の最も長い string の長さです。

mxArray はデータ要素を C の char ではなく mxChar として表します。

入力引数

m — 文字列の数

mwSize

文字列の数。mwSize として指定します。

str — string の配列

const char **

string の配列。const char ** として指定します。この配列は少なくとも m 個の文字列を含まなければなりません。

出力引数

pm — mxArray へのポインター

mxArray * | NULL

mxChar 型の mxArray へのポインター。mxArray * として指定します。

関数は、str に含まれている文字列が m 個未満の場合や、mxArray を作成するのに十分な空きヒープ領域がない場合、失敗します。

• MEX ファイル — 関数は MEX ファイルを終了し、制御を MATLAB^® プロンプトに戻します。

• スタンドアロン (非 MEX ファイル) アプリケーション — 関数は NULL を返します。

例

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

• mxcreatecharmatrixfromstr.c

バージョン履歴

R2006a より前に導入

参考

mxCreateCharArray | mxCreateString | mxGetString