Main Content

mxCreateString (Fortran)

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

Fortran 構文

#include "fintrf.h"
mwPointer mxCreateString(str)
character*(*) str

説明

mxCreateString を使用して、str に初期化された mxArray を作成します。strcmpupper など、多くの MATLAB® 関数には、string 配列の入力が必要です。

mxCreateString は、マルチバイトとシングルバイトのエンコードされた文字をどちらもサポートします。Windows® および Linux® プラットフォームでは、ユーザーのロケール設定により既定のエンコードが指定されます。

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

入力引数

すべて展開する

文字列。character*(*) として指定します。ASCII 文字のみがサポートされます。

出力引数

すべて展開する

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

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

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

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

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

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

バージョン履歴

R2006a より前に導入