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

Как выйти из процесса

Выполните следующие действия, чтобы запустить функцию C++ MEX вне процесса:

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

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

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

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

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

Можно запустить другие функции C++ MEX в том же процессе, используя ту же 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.

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

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

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

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

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

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

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

mex -output arrayProductMEX -outdir MyPathFolder arrayProduct.cpp

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

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

result =

     2     4     6     8

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

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

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