Main Content

matlab::engine::connectMATLAB

共有 MATLAB セッションに同期的に接続する

説明

std::unique_ptr<MATLABEngine> connectMATLAB()

std::unique_ptr<MATLABEngine> connectMATLAB(const matlab::engine::String& name)

ローカル マシン上の共有 MATLAB® セッションに同期的に接続します。

  • 共有 MATLAB セッションの名前を指定してもエンジンがその名前のセッションを見つけられない場合、エンジンは例外をスローします。

  • 名前を指定せず、使用可能な共有 MATLAB セッションがない場合、エンジンは新しい共有 MATLAB セッションを開始します。MATLAB デスクトップは起動しません。

  • 名前を指定せず、使用可能な共有 MATLAB セッションが存在する場合、エンジンは使用可能な最初のセッションに接続します。

インクルード

名前空間:

matlab::engine
インクルードMatlabEngine.hpp

パラメーター

const matlab::engine::String& name

共有 MATLAB セッションの名前

戻り値

std::unique_ptr<MATLABEngine>

MATLABEngine オブジェクトへのポインター

例外

matlab::engine::EngineException

指定された MATLAB セッションへの関数による接続が失敗すると、例外がスローされます。

すべて展開する

my_matlab という名前の共有 MATLAB セッションに接続します。

std::unique_ptr<MATLABEngine> matlabPtr = connectMATLAB(u"my_matlab");

バージョン履歴

R2017b で導入