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 として表します。

入力引数

すべて展開する

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

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

出力引数

すべて展開する

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

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

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

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

例

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

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

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

バージョン履歴

R2006a より前に導入

参考

| |