matlab::cpplib::initMATLABApplication

MATLAB Runtime を起動してそのアプリケーション状態を初期化

説明

std::shared_ptr<MATLABApplication> initMATLABApplication(matlab::cpplib::MATLABApplicationMode mode, const std::vector<std::u16string>& options = std::vector<std::u16string>())

matlab.cpplib.initMATLABApplication は、モードと起動オプションの配列 (オプション) を入力として受け入れます。MATLABApplication オブジェクトへの共有ポインターを返します。共有ポインターが関数 matlab::cpplib::initMATLABLibrary に渡され、ユーザー記述ライブラリへの一意のポインターが返されます。その後、この一意のポインターがライブラリからの MATLAB^® 関数の呼び出しに使用されます。

このメソッドはプロセスで 1 回だけ呼び出す必要があります。

パラメーター

MATLABApplicationMode mode

アプリケーションの起動モード:

MATLABApplicationMode::IN_PROCESS
MATLABApplicationMode::OUT_OF_PROCESS

const std::vector<std::u16string>& options

MATLAB Runtime を起動するために使用する起動オプション。以下が含まれます。

-nodisplay:Linux^® で MATLAB Runtime を表示機能なしで起動します。
-nojvm:既定で有効に設定されている Java^® 仮想マシンを無効にします。
-logfile filepath:パス filepath のログファイルに書き込みます。-logfile と filepath を連続する個別の変数として指定する必要があります。

戻り値

std::shared_ptr<MATLABApplication>

アプリケーション状態をカプセル化する MATLABApplication オブジェクトへのポインター。

例外

matlab::cpplib::ApplicationLaunchError

関数が起動に失敗しました。

例

MATLAB Runtime をインプロセスで既定の Runtime オプションで起動

std::shared_ptr<MATLABApplication> appPtr = initMATLABApplication(MATLABApplicationMode::IN_PROCESS);

MATLAB Runtime をアウトプロセスで Java 仮想マシンなしで起動

std::vector<std::string> opts = {"-nojvm"};
std::shared_ptr<MATLABApplication> appPtr = initMATLABApplication(MATLABApplicationMode::OUT_OF_PROCESS, opts);

MATLAB Runtime をインプロセスで起動してログファイルを生成

std::vector<std::u16string> opts = {u"-logfile", 
						u"C:\\somepath\\matlab_app.log"};
std::shared_ptr<MATLABApplication> appPtr = initMATLABApplication(MATLABApplicationMode::IN_PROCESS, opts);