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

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

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

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

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

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

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

Используйте метод feval, чтобы запустить MEX-функцию C++ arrayProduct в хост-процессе. Передайте имя 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++ в том процессе.

Например, предположите, что вы хотите создать функцию обертки для MEX-функции C++ arrayProduct.cpp, которая включена в документацию как пример. Создайте функцию 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++ из процесса.

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