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

Функции в разделяемой библиотеке

Разделяемая библиотека, сгенерированная MATLAB^® Compiler SDK™, содержит по крайней мере семь функций. Существует три сгенерированных функции, чтобы справиться с инициализацией библиотеки и завершением, один каждый для печатных выходных сигналов и сообщений об ошибке и двух сгенерированных функций для каждого файла MATLAB, скомпилированного в библиотеку.

Чтобы сгенерировать функции, описанные в этом разделе, сначала скопируйте sierpinski.m, и triangle.c, чтобы создать C совместно использовал библиотеку, triangle_legacy.cpp, чтобы создать API mwArray C++ совместно использовал библиотеку, или triangle_generic.cpp, чтобы создать MATLAB Data API C++ совместно использовал библиотеку в вашу директорию. Файлы найдены в matlabroot\extern\examples\compilersdk\c_cpp\triangle.

Тип приложения

Создайте разделяемую библиотеку, как объяснено в, Создают C/C++ Разделяемые Библиотеки из Командной строки. Если ваша разделяемая библиотека создается, выполните следующую команду mbuild, которая соответствует вашей платформе разработки. Эта команда использует ваш компилятор C/C++, чтобы скомпилировать код и соединиться, код драйвера против MATLAB сгенерировал совместно использованную библиотеку C/C++.

Для приложения C используйте mbuild triangle.c libmatrix.lib.

Для C++ приложение API mwArray используйте mbuild triangle_legacy.cpp libtriangle.lib

Для C++ приложение MATLAB Data API используйте mbuild matrix_mda.cpp libtriangle.lib

Эти команды создают основную программу под названием triangle и разделяемую библиотеку под названием libtriangle. Библиотека экспортирует одну функцию, которая использует простой итеративный алгоритм (содержавшийся в sierpinski.m), чтобы сгенерировать фрактал, известный как Треугольник Серпинскего. Основная программа в triangle.c, triangle_legacy.cpp, triangle_generic.cpp может опционально взять один числовой аргумент, который, если есть указывает, что число точек раньше генерировало фрактал. Например, triangle 8000 генерирует схему с 8 000 точек.

В этом примере MATLAB Compiler SDK помещает все сгенерированные функции в сгенерированный файл libtriangle.c или libtriangle.cpp.

Структура программ тот вызов разделяемые библиотеки

Все программы, которые вызывают сгенерированные совместно использованные библиотеки MATLAB Compiler SDK, имеют примерно ту же структуру:

Чтобы видеть эти шаги в фактическом примере, рассмотрите основную программу в этом примере, triangle.c.

Инициализация библиотеки и функции завершения

Функции инициализации и завершения библиотеки создают и уничтожают, соответственно, экземпляр MATLAB Runtime, требуемый разделяемой библиотекой. Необходимо вызвать функцию инициализации, прежде чем вы вызовете любую из других функций в разделяемой библиотеке, и необходимо вызвать функцию завершения после того, как вы закончены, выполнив вызовы в разделяемую библиотеку (или вы рискуете пропускать память).

Существует две формы функции инициализации и один тип функции завершения. Более простая из двух функций инициализации не берет аргументов; скорее всего, это - версия, которую вызовет ваше приложение. В этом примере эта форма функции инициализации называется libtriangleInitialize.

bool libtriangleInitialize(void)

Эта функция создает экземпляр MATLAB Runtime с помощью печати по умолчанию и обработчиков ошибок и другой информации, сгенерированной во время процесса компиляции.

Однако, если вы хотите больше управления тем, как печатные выходные сигналы и сообщения об ошибке обработаны, можно вызвать вторую форму функции, которая берет два аргумента.

bool libtriangleInitializeWithHandlers(
    mclOutputHandlerFcn error_handler,
    mclOutputHandlerFcn print_handler
)

Путем вызывания этой функции можно обеспечить собственные версии печати и процедур обработки ошибок, вызванных MATLAB Runtime. Каждая из этих стандартных программ имеет ту же подпись (для полных деталей, смотрите Функции Печати и Обработки ошибок). Путем переопределения значений по умолчанию можно управлять, как выведенный отображен и, например, входит ли это в файл журнала.

На платформах Windows Microsoft^® MATLAB Compiler SDK генерирует дополнительную функцию инициализации, стандартная функция инициализации Microsoft DLL DllMain.

BOOL WINAPI DllMain(HINSTANCE hInstance, DWORD dwReason,  
                    void *pv)

Сгенерированный DllMain выполняет очень важный сервис; это определяет местоположение директории, в которой разделяемая библиотека хранится на диске. Эта информация используется, чтобы найти развертываемый архив, без которого не запустится приложение. Если вы изменяете сгенерированный DllMain (не рекомендуемый), убедитесь, что вы сохраняете эту часть его функциональности.

Завершение библиотеки просто.

void libtriangleTerminate(void)

Вызовите эту функцию (однажды для каждой библиотеки) прежде, чем вызвать mclTerminateApplication.

Печать и функции обработки ошибок

По умолчанию MATLAB Compiler SDK сгенерировал приложения и совместно использовал библиотеки, отправляют распечатанный вывод в стандартный вывод и сообщения об ошибке к стандартной погрешности. MATLAB Compiler SDK генерирует обработчик печати по умолчанию и обработчик ошибок по умолчанию, которые проводят эту политику. Если требуется изменить это поведение, необходимо записать собственную ошибку и обработчики печати и передать их в соответствующей сгенерированной функции инициализации.

Можно заменить или, оба или ни одна из этих двух функций. MATLAB Runtime отправляет весь регулярный вывод через обработчик печати и весь вывод ошибок через обработчик ошибок. Поэтому, если вы переопределите любую из этих функций, MATLAB Runtime будет использовать вашу версию функции для всего вывода, который попадает в класс, для которого это вызывает тот обработчик.

Обработчик печати по умолчанию принимает следующую форму.

static int mclDefaultPrintHandler(const char *s)

Реализация является прямой; это берет строку, распечатывает его на стандартном выводе и возвращает количество распечатанных символов. Если вы заменяете или заменяете эту функцию, ваша версия должна также взять строку и возвратить количество “обработанных” символов. MATLAB Runtime вызывает обработчик печати, когда выполняющийся файл MATLAB выполняет запрос для печатного вывода, например, через функцию MATLAB disp. Обработчик печати не отключает вывод с возвратом каретки или переводом строки.

Обработчик ошибок по умолчанию имеет ту же форму как обработчик печати.

static int mclDefaultErrorHandler(const char *s)

Однако реализация по умолчанию обработчика печати немного отличается. Это отправляет вывод в поток вывода стандартной погрешности, но если строка не заканчивается возвратом каретки, обработчик ошибок добавляет тот. Если вы заменяете обработчик ошибок по умолчанию на одно собственное, необходимо выполнить эту проверку также, или некоторые сообщения об ошибке, распечатанные MATLAB Runtime, не будут правильно отформатированы.

extern "C" int myPrintHandler(const char *s); 

Функции, сгенерированные от файлов MATLAB

Для каждого файла MATLAB, заданного на командной строке MATLAB Compiler SDK, продукт генерирует две функции, функцию mlx и функцию mlf. Каждая из этих сгенерированных функций выполняет то же действие (вызывает вашу функцию файла MATLAB). Две функции имеют различные имена и представляют различные интерфейсы. Имя каждой функции основано на имени первой функции в файле MATLAB (sierpinski в этом примере); каждая функция начинается с различного трехбуквенного префикса.

void mlxSierpinski(int nlhs, mxArray *plhs[], int nrhs,
                   mxArray *prhs[])

void mlfSierpinski(int nargout, mxArray** x, mxArray** y,
                   mxArray* iterations, mxArray* draw)

mlfSierpinski(2, &x, &y, iterations, draw);

[a,b,varargout] = myfun(x,y,z,varargin)

void mlfMyfun(int numOfRetVars, mxArray **a, mxArray **b, 
              mxArray **varargout, mxArray *x, mxArray *y,
              mxArray *z, mxArray *varargin)

... 'FOO' : function does not take 0 arguments

  mwArray junk; 
  FOO(junk); 

 FOO((mwArray)NULL);

No input no output:
void foo() 

Only inputs:
void foo(const mwArray& varargin)

Only outputs:
void foo(int nargout, mwArray& varargout)

Most generic form that has both inputs and outputs:
void foo(int nargout, mwArray& varargout, 
                       const mwArray& varargin) 

Most generic form that has outputs and all the inputs
void foo(int nargout, mwArray& varargout, const 
                             mwArray& i1, const 
                             mwArray& i2, const 
                              mwArray& varargin)

Only inputs:
void foo(const mwArray& i1, 
      const mwArray& i2, const mwArray& varargin)

Most generic form that has all the outputs and inputs
void foo(int nargout, mwArray& o1, mwArray& o2, 
                            mwArray& varargout, 
                        const mwArray& varargin)


Only outputs:
void foo(int nargout, mwArray& o1, mwArray& o2, 
                                   mwArray& varargout)

Most generic form that has all the outputs and 
                                      all the inputs
void foo(int nargout, mwArray& o1, mwArray& o2, 

mwArray& varargout, 
         const mwArray& i1, const mwArray& i2, 
                       const mwArray& varargin)

Получение информации о состоянии MATLAB Runtime, в то время как пользующиеся разделяемые библиотеки

При использовании разделяемых библиотек можно вызвать функции, чтобы получить определенную информацию из состояния MATLAB Runtime. Для получения дополнительной информации смотрите Набор и Получите Данные MATLAB Runtime для Разделяемых Библиотек.