exponenta event banner

matlab:: cpplib:: initMATLABApplication

Запуск среды выполнения MATLAB и инициализация ее состояния приложения

Описание

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 ® из библиотеки

Процесс должен вызывать этот метод только один раз.

Параметры

MATLABApplicationMode mode

Режим запуска приложения:

  • MATLABApplicationMode::IN_PROCESS

  • MATLABApplicationMode::OUT_OF_PROCESS

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

Параметры запуска, используемые для запуска среды выполнения MATLAB. К ним относятся:

  • -nodisplay: Запуск среды выполнения MATLAB без функции отображения в Linux ®.

  • -nojvm: Отключает виртуальную машину Java ®, которая включена по умолчанию.

  • -logfile filepath: Запись в файл журнала с указанием пути filepath. -logfile и filepath должен быть указан как отдельный последовательный аргумент.

Возвращаемое значение

std::shared_ptr<MATLABApplication>

Указатель на MATLABApplication объект, инкапсулирующий состояние приложения.

Исключения

matlab::cpplib::ApplicationLaunchError

Не удалось запустить функцию.

Примеры

Запуск среды выполнения MATLAB в процессе с параметрами среды выполнения по умолчанию

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

Запуск среды выполнения MATLAB без виртуальной машины Java

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

Запуск среды выполнения MATLAB в процессе и создание файла журнала

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

Представлен в R2018a