Main Content

mxCreateString (C)

指定された文字列に初期化された 1 次元配列

C 構文

#include "matrix.h"
mxArray *mxCreateString(const char *str);

説明

mxCreateString を使用して、str から初期化された mxArray を作成します。

mxArray の使用が終わったら、mxDestroyArray を呼び出します。

入力引数

すべて展開する

文字列。const char * として指定します。この文字列のエンコードには、UTF-8、または下位互換性のためにローカル コード ページ (LCP) エンコードを使用できます。

出力引数

すべて展開する

mxArray へのポインター。成功した場合は mxArray * として指定します。

関数は、mxArray を作成するのに十分な空きヒープ領域がない場合、失敗します。

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

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

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

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

バージョン履歴

R2006a より前に導入

すべて展開する