Документация

Как у закончиться процесс

Выполните эти шаги, чтобы запустить вашу MEX-функцию C++ из процесса:

При исчерпывании процесса MEX-функции C++ всегда выполняются в той же папке как текущая папка MATLAB. Изменение текущей папки MATLAB после создания объекта хоста MEX приводит к тому же изменению в контексте MEX-функции C++.

Выполнение arrayProduct MEX-функция из процесса

Следующий пример запускает arrayProduct MEX-функция C++ из процесса. Исходный код C++ MEX доступен в файле arrayProduct.cpp. Чтобы использовать этот пример MEX-функция C++, откройте arrayProduct.cpp исходный файл, сохраните его на своем пути MATLAB и создайте MEX-функцию C++ с помощью инструкций в Сборке Программы C++ MEX.

После создания MEX-функции C++ запустите хост-процесс MEX с помощью mexhost функция. Эта функция возвращает объект matlab.mex.MexHost класс.

Используйте feval метод, чтобы запустить arrayProduct MEX-функция C++ в хост-процессе. Передайте имя MEX-функций C++ и аргументы к feval. Возвратите результаты в MATLAB путем присвоения выхода feval.

mh = mexhost;
result = feval(mh,'arrayProduct',2,[1 2 3 4])

result =
     2     4     6     8

Запустите arrayProduct в другом хост-процессе MEX. Сначала создайте хост-процесс MEX путем вызова mexhost снова и присвоение выхода к различной переменной. Затем вызовите feval на новом хосте.

mh2 = mexhost;
result2 = feval(mh2,'arrayProduct',2,rand(1,10));

Можно запустить другие MEX-функции C++ в том же процессе с помощью того же matlab.mex.MexHost объект возвращен mexhost.

result2 = feval(mh2,'anotherMexFunction',inputs);

Жизненный цикл процесса

Жизненный цикл хост-процесса MEX связывается с жизненным циклом matlab.mex.MexHost объект возвращен mexhost. Как любой объект указателя, MATLAB вызывает delete метод, когда на объект больше не ссылаются нигде. Если MATLAB вызывает delete или если вы вызываете delete на объекте явным образом, MATLAB заканчивает процесс, сопоставленный MexHost объект.

Можно закончить процесс явным образом путем вызова clear функция с любой из этих опций:

Получение информации о хост-процесс MEX

Используйте matlab.mex.MexHost объект получить информацию о хост-процессе MEX. Эти свойства предоставляют информацию о процессе и загруженных функциях.

Для получения дополнительной информации об этих свойствах смотрите matlab.mex.MexHost.

У всегда заканчивайся процесс

В определенных случаях вы можете всегда хотеть запустить свою MEX-функцию C++ из процесса. Например, исчерпывание процесса может быть необходимым, если существуют сторонние конфликты библиотеки между MATLAB и MEX-функцией C++.

Чтобы обеспечить удобный способ запустить MEX-функцию C++ из процесса, создайте функцию MATLAB обертки. Функция обертки создает объект хоста MEX и запускает MEX-функцию C++ в том процессе.

Например, предположите, что вы хотите создать функцию обертки для arrayProduct.cpp MEX-функция C++, которая включена в документацию как пример. Создайте функцию MATLAB с именем arrayProduct.m и помещенный этот файл в папку, которая находится на пути MATLAB. Создайте MEX-функцию C++ и присвойте другое имя для скомпилированного файла MEX.

Функция обертки создает matlab.mex.MexHost объект, который присвоен персистентной переменной так, чтобы процесс не был уничтожен между последующими вызовами функции обертки. Функция использует этот объект вызвать feval метод для выполнения из процесса MEX-функции C++. Если объект хоста MEX не допустим, то функция создает хост-процесс MEX.

function result = arrayProduct(scalefactor,inputarray)
    persistent mh
    if ~(isa(mh,'matlab.mex.MexHost') && isvalid(mh))
        mh = mexhost;
    end
    result = feval(mh,"arrayProductMEX",scalefactor,inputarray);
end

Чтобы создать MEX-функцию C++, откройте arrayProduct.cpp исходный файл и сохраняет его на вашем пути MATLAB. Создайте MEX-функцию C++ с помощью инструкций в этой теме, Сборка Программы C++ MEX.

Следующая команда создает файл MEX с корневым именем arrayProductMEX и помещает его в папку с функцией обертки, которая принята, чтобы быть MyPathFolder в этом примере. mex команда создает папку, если это не существует.

mex -output arrayProductMEX -outdir MyPathFolder arrayProduct.cpp

Чтобы использовать MEX-функцию C++, вызовите его из командной строки как любая функция через функцию обертки.

result = arrayProduct(2,[1 2 3 4]);
result

result =

     2     4     6     8

Следующий код вызывает MEX-функцию C++ в for цикл. Первый вызов arrayProduct создает хост-процесс MEX. Последующие вызовы используют тот же процесс, если процесс не уничтожается, например, катастрофический отказ MEX-функции C++.

for k = 1:5
   results(k,:) = arrayProduct(k,[1 2 3 4]);
end
results

results =
     1     2     3     4
     2     4     6     8
     3     6     9    12
     4     8    12    16
     5    10    15    20

Чтобы уничтожить хост-процесс MEX, очистите все функции, которые задают переменную хост-процесса MEX (mh в этом примере) как персистентный. В этом примере очистите arrayProduct.m функция.

clear arrayProduct.m

Вызов clear functions вызывает разрушение matlab.mex.MexHost объект, который хранится в персистентной переменной и поэтому отключает хост-процесс MEX.

Отладка MEX-функций из процесса

Можно присоединить отладчик C++ к MEX-функции C++ и установить точки останова отлаживать программу. Вот шаги, чтобы настроить и отладить MEX-функцию C++ из процесса.

Для получения информации об использовании определенных отладчиков см. документацию для тех отладчиков.