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

Задайте функцию MATLAB

Задайте функцию MATLAB errorCheckExample в отдельном файле. Эта функция вычисляет квадратный корень из своего входного параметра:

type errorCheckExample

function y = errorCheckExample(x)
y = sqrt(x);
end

Сгенерируйте библиотеку C и исполняемый файл

Сгенерируйте динамически соединенную библиотеку C для errorCheckExample это принимает двойной скалярный вход. Используйте объект настройки кода с RuntimeChecks набор параметров к true. Кроме того, используйте -d опция, чтобы назвать папку генерации кода как codegen_c_dll.

cfg = coder.config('dll');
cfg.RuntimeChecks = true;
codegen -config cfg errorCheckExample -args 1 -d codegan_c_dll -report

Code generation successful: To view the report, open('codegan_c_dll/html/report.mldatx').

Откройте отчет генерации кода и смотрите файл errorCheckExample.c. Функция C, сгенерированная для вашей функции MATLAB, имеет подпись double errorCheckExample(double x). Вычислить квадратный корень, errorCheckExample вызывает sqrt библиотечная функция, которая вычисляет только действительные квадратные корни. Так, errorCheckExample может принять только положительные входные параметры. Для отрицательных входных параметров, errorCheckExample вызывает сгенерированную служебную функцию rtErrorWithMessageID это использует fprintf записать сообщение об ошибке в stderr и затем использование abort отключать приложение.

static void rtErrorWithMessageID(const int b, const char *c,
                                 const char *aFcnName, int aLineNum)
{
  fprintf(stderr,
          "Domain error. To compute complex results from real x, use "
          "\'%.*s(complex(x))\'.",
          b, c);
  fprintf(stderr, "\n");
  fprintf(stderr, "Error in %s (line %d)", aFcnName, aLineNum);
  fprintf(stderr, "\n");
  fflush(stderr);
  abort();
}

При генерации кода библиотеки генератор кода также производит пример основные файлы main.h и main.c в examples подпапка папки сборки. Поддержка C файлы main_runtime_check.h и main_runtime_check.c измененные версии этих файлов в качестве примера. Модифицированный main функция вызывает errorCheckExample(-4), который производит ошибку времени выполнения.

Запустите эти команды, чтобы сгенерировать исполняемый файл C с помощью модифицированных основных файлов. Назовите папку codegen_c_exe генерации кода. Назовите исполняемый файл errorCheckExample_c при помощи -o опция с codegen команда.

cfg = coder.config('exe');
cfg.RuntimeChecks = true;
cfg.CustomSource = 'main_runtime_check.c';
cfg.CustomInclude = pwd;

codegen -config cfg main_runtime_check.c main_runtime_check.h errorCheckExample -args 1 -o errorCheckExample_c -d codegen_c_exe

Code generation successful.

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

if isunix
    system('./errorCheckExample_c');
elseif ispc
    system('errorCheckExample_c.exe');
else
    disp('Platform is not supported');
end

Domain error. To compute complex results from real x, use 'sqrt(complex(x))'.
Error in sqrt (line 13)
./errorCheckExample_c: Aborted

Сгенерируйте библиотеку C++ и исполняемый файл

Сгенерируйте динамически соединенную библиотеку C++ для errorCheckExample это принимает скаляр дважды вход. Используйте объект настройки кода с RuntimeChecks набор параметров к true. Кроме того, используйте -d опция, чтобы назвать папку генерации кода как codegen_cpp_dll.

cfg = coder.config('dll');
cfg.RuntimeChecks = true;
codegen -config cfg -lang:c++ errorCheckExample -args 1 -d codegen_cpp_dll -report

Code generation successful: To view the report, open('codegen_cpp_dll/html/report.mldatx').

Откройте отчет генерации кода и смотрите файл errorCheckExample.cpp. Подобно функции C, сгенерированной в предыдущем разделе, errorCheckExample может принять только положительные входные параметры. Для отрицательных входных параметров, errorCheckExample вызывает служебную функцию rtErrorWithMessageID. Но в этом случае, служебная функция выдает std:runtime_error исключение, которое можно отловить и обработать в рукописном main функция.

static void rtErrorWithMessageID(const char *b, const char *aFcnName,
                                 int aLineNum)
{
  std::stringstream outStream;
  ((outStream << "Domain error. To compute complex results from real x, use \'")
   << b)
      << "(complex(x))\'.";
  outStream << "\n";
  ((((outStream << "Error in ") << aFcnName) << " (line ") << aLineNum) << ")";
  throw std::runtime_error(outStream.str());
}

При генерации кода библиотеки генератор кода также производит пример основные файлы main.h и main.c в examples подпапка папки сборки. Поддержка файлы C++ main_runtime_check.hpp и main_runtime_check.cpp измененные версии этих файлов в качестве примера. Модифицированный main() функция вызывает errorCheckExample(-4) в try-catch блок. Блок отлавливает исключение и распечатывает модифицированное сообщение путем предварительного ожидания строки "Caught excaption: " к сообщению, что перехваченная исключительная ситуация содержит.

Запустите эти команды, чтобы сгенерировать исполняемый файл C++ использование модифицированных основных файлов. Назовите папку codegen_cpp_exe генерации кода. Назовите исполняемый файл errorCheckExample_cpp.

cfg = coder.config('exe');
cfg.RuntimeChecks = true;
cfg.CustomSource = 'main_runtime_check.cpp';
cfg.CustomInclude = pwd;

codegen -config cfg -lang:c++ main_runtime_check.cpp main_runtime_check.hpp errorCheckExample -args 1 -o errorCheckExample_cpp -d codegen_cpp_exe

Code generation successful.

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

if isunix
    system('./errorCheckExample_cpp');
elseif ispc
    system('errorCheckExample_cpp.exe');
else
    disp('Platform is not supported');
end

Caught exception: Domain error. To compute complex results from real x, use 'sqrt(complex(x))'.
Error in sqrt (line 13)