Main Content

mclInitializeApplication

現在のプロセスで作成されたすべての MATLAB Runtime インスタンスによって共有されるアプリケーション状態の設定

説明

bool mclInitializeApplication(const char **options, int count) は現在のプロセスで作成されたすべての MATLAB® Runtime インスタンスによって共有されるアプリケーション状態を設定します。この関数は、追加の MATLAB Runtime オプションを指定する char* C スタイル文字列の配列 (長さがゼロの場合もあり) と、string 配列のサイズを指定するカウントを受け取ります。

すべて折りたたむ

C/C++ アプリケーション コードの main 関数で、mclInitializeApplication を呼び出してすべての MATLAB Runtime インスタンスを起動します。

/* Call the mclInitializeApplication routine. Make sure that the application * was initialized properly by checking the return status. This initialization * has to be done before calling any MATLAB APIs or MATLAB Compiler SDK * generated shared library functions. */ if (!mclInitializeApplication(nullptr, 0)) { std::cerr << "Could not initialize the application." << std::endl; return -1; }

注意

mclInitializeApplication は、プロセスごとに 1 回のみ呼び出す必要があります。mclInitializeApplication を複数回呼び出すと、アプリケーションが予測できない、または望ましくない動作を示す可能性があります。

C/C++ アプリケーション コードの main 関数で、mclInitializeApplication を呼び出し、-nodisplay オプションを指定してすべての MATLAB Runtime インスタンスを起動します。

const char *args[] = {"-logfile", "mylogfile.txt"}; if (! mclInitializeApplication(args, 2)) { fprintf(stderr, "An error occurred while initializing."); return -1; }

入力引数

すべて折りたたむ

MATLAB Runtime オプション。char* C スタイル文字列の配列として指定します。配列には、次の MATLAB コマンド ライン スイッチが含まれている場合があります。

  • -automation

  • -jdb portnumber

  • -logfile filename

  • -noFigureWindows

  • -nosplash

  • -r statement

  • -regserver

  • -softwareopengl

  • -unregserver

上記に加え、Linux® では次のオプションが有効です。

  • -debug

  • -display xDisp

  • -nodisplay

  • -nojvm

  • -singleCompThread

これらのスイッチは、MATLAB で使用した場合と同じ意味をもちます。詳細については、ご使用のプラットフォームの関数 matlab を参照してください。

注意

Mac 上での実行時に、options に含めるオプションの 1 つとして -nodisplay を使用する場合、mclInitializeApplication の呼び出しは mclRunMain の呼び出しよりも前に行う必要があります。

例: {"-singleCompThread", "-nodisplay"}

options string 配列のサイズ。整数として指定します。

例: 2

出力引数

すべて折りたたむ

初期化結果。ブール値として返されます。結果は初期化が正常に行われたかどうかを示します。関数が false を返す場合、それ以降コンパイルされた関数を呼び出すと、予期しない動作が発生することがあります。

バージョン履歴

R2009a で導入