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

Как завершить процесс

Выполните следующие действия, чтобы запустить функцию 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 Host

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

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

Всегда завершать процесс

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

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

Например, предположим, что необходимо создать функцию-оболочку для arrayProduct.cpp Функция C++ 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 с именем root arrayProductMEX и помещает его в папку с функцией оболочки, которая считается MyPathFolder в этом примере. mex создает папку, если она не существует.

mex -output arrayProductMEX -outdir MyPathFolder arrayProduct.cpp

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

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 вне процесса.

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