coder.target

确定代码生成目标是否为指定的目标

全页折叠

语法

tf = coder.target(target)

说明

如果代码生成目标是 target，则 tf = coder.target(target) 返回 true (1)。否则，它返回 false (0)。

如果为 MATLAB^® 类生成代码，则 MATLAB 会在代码生成之前加载类时计算类的初始值。如果您在 MATLAB 类属性初始化中使用 coder.target，coder.target('MATLAB') 将返回 true。

示例

全部折叠

使用 `coder.target` 参数化 MATLAB 函数

参数化 MATLAB 函数，使其能够在 MATLAB 或生成代码中工作。当函数在 MATLAB 中运行时，它会调用 MATLAB 函数 myabsval。然而，生成的代码会调用 C 库函数 myabsval。

编写 MATLAB 函数 myabsval。

function y = myabsval(u)   
%#codegen
y = abs(u);

通过使用 -args 选项指定输入参数的大小、类型和复/实性，为 myabsval 生成 C 静态库。

codegen -config:lib myabsval -args {0.0}

codegen 函数在文件夹 \codegen\lib\myabsval 中创建库文件 myabsval.lib 和头文件 myabsval.h。（库文件扩展名可以根据您的平台而有所不同。）它在同一个文件夹中生成函数 myabsval_initialize 和 myabsval_terminate。

编写一个 MATLAB 函数，以使用 coder.ceval 调用生成的 C 库函数。

function y = callmyabsval(y)  
%#codegen
% Check the target. Do not use coder.ceval if callmyabsval is
% executing in MATLAB
if coder.target('MATLAB')
  % Executing in MATLAB, call function myabsval
  y = myabsval(y);
else
  % add the required include statements to generated function code
  coder.updateBuildInfo('addIncludePaths','$(START_DIR)\codegen\lib\myabsval');
  coder.cinclude('myabsval_initialize.h');
  coder.cinclude('myabsval.h');
  coder.cinclude('myabsval_terminate.h');

  % Executing in the generated code. 
  % Call the initialize function before calling the 
  % C function for the first time
  coder.ceval('myabsval_initialize');

  % Call the generated C library function myabsval
  y = coder.ceval('myabsval',y);
  
  % Call the terminate function after
  % calling the C function for the last time
  coder.ceval('myabsval_terminate');
end

生成 MEX 函数 callmyabsval_mex。在命令行中提供生成的库文件。

codegen -config:mex callmyabsval codegen\lib\myabsval\myabsval.lib -args {-2.75}

您可以使用 coder.updateBuildInfo 在函数中指定该库，而不是在命令行中提供库。使用此选项可预配置编译。将以下行添加到 else 模块中：

coder.updateBuildInfo('addLinkObjects','myabsval.lib','$(START_DIR)\codegen\lib\myabsval',100,true,true);

运行调用库函数 myabsval 的 MEX 函数 callmyabsval_mex。

callmyabsval_mex(-2.75)

ans =

    2.7500

调用 MATLAB 函数 callmyabsval。

callmyabsval(-2.75)

ans =

    2.7500

callmyabsval 函数在 MATLAB 和代码生成中的执行均展示出了预期的行为。

输入参数

全部折叠

`target` — 代码生成目标
`'MATLAB'` | `'C'` | `'C++'` | `'CUDA'` | `'HLS'` | `'SystemVerilog'` | `'Verilog'` | `'VHDL'` | `'MEX'` | `'Sfun'` | `'Rtw'` | `'HDL '` | `'Custom'`

代码生成目标，指定为字符向量或字符串标量。指定下列目标之一。

`'MATLAB'`	在 MATLAB 中运行（不生成代码）
`'C'`, `'C++'`, `'CUDA'`, `'HLS'`, `'SystemVerilog'`, `'Verilog'`, `'VHDL'`	代码生成支持的目标语言
`'MEX'`	生成 MEX 函数
`'Sfun'`	仿真 Simulink^® 模型。也用于在加速模式下运行。
`'Rtw'`	生成 LIB、DLL 或 EXE 目标。也用于在 Simulink Coder™ 和快速加速模式下运行。
`'HDL'`	生成 HDL 目标
`'Custom'`	生成自定义目标