coder.config

创建代码生成配置对象

全页折叠

语法

config_obj = coder.config
config_obj = coder.config(build_type)
config_obj = coder.config(build_type,'ecoder',ecoder_flag)
config_obj = coder.config(numeric_conversion_type)

说明

使用 coder.config 函数为 MEX 代码生成、独立代码生成、定点转换和单精度转换创建配置对象。修改配置对象的属性，根据工程要求（如可读性、性能、硬件要求和自定义库的使用）自定义生成的代码。

config_obj = coder.config 创建一个 coder.MexCodeConfig 代码生成配置对象，该对象与 codegen 一起使用来生成 MEX 函数。将 coder.MexCodeConfig 对象与 codegen 命令的 -config 选项结合使用。

示例

config_obj = coder.config(build_type) 创建一个代码生成配置对象，该对象与 codegen 结合使用来生成 MEX 函数或独立代码（静态库、动态链接库或可执行程序）。将该代码生成配置对象与 codegen 命令的 -config 选项结合使用。

示例

config_obj = coder.config(build_type,'ecoder',ecoder_flag) 根据 ecoder_flag 是 true 还是 false 来创建 coder.EmbeddedCodeConfig 对象或 coder.CodeConfig 对象。build_type 为 'lib'、'dll' 或 'exe'。将标志设置为 true 以使用以下功能：

  • 通过执行软件在环 (SIL) 和处理器在环 (PIL) 来验证代码。

  • 代码追溯或双向可追溯性。

  • 硬件特定优化和自定义替换库。

  • 自定义生成的代码的外观。

请参阅从 MATLAB 代码中生成代码的 Embedded Coder 功能 (Embedded Coder)。

示例

config_obj = coder.config(numeric_conversion_type) 创建以下配置对象来与 codegen 结合使用：

  • coder.FixPtConfig（当从浮点 MATLAB® 代码生成定点 MATLAB 或 C/C++ 代码时）。与 codegen 命令的 -float2fixed 选项结合使用。

  • coder.SingleConfig (Fixed-Point Designer)（从双精度 MATLAB 代码生成单精度 MATLAB 代码时）。与 codegen 命令的 -double2single 选项结合使用。

定点转换或单精度转换需要 Fixed-Point Designer™。

注意

使用 coder.config 函数创建代码配置对象后，您可以在命令行以编程方式修改其属性，也可以使用配置参数对话框以交互方式修改其属性。请参阅Specify Code Configuration Parameters Interactively。

示例

示例

全部折叠

从 MATLAB 函数生成适合代码生成并支持代码生成报告的 MEX 函数。

编写一个 MATLAB 函数 coderand，该函数在开区间 (0,1) 上基于标准均匀分布生成一个随机标量值。

function r = coderand() %#codegen
% The directive %#codegen declares that the function
% is intended for code generation
r = rand();

创建一个代码生成配置对象来生成 MEX 函数。

cfg = coder.config % or cfg = coder.config('mex')

打开代码生成报告。

cfg.GenerateReport = true;

通过使用 -config 选项，在当前文件夹中生成指定配置对象的 MEX 函数。

% Generate a MEX function and code generation report
codegen -config cfg coderand

为独立 C 静态库创建一个代码生成配置对象。

cfg = coder.config('lib')
% Returns a coder.EmbeddedCodeConfig object if the Embedded 
% Coder product is installed. 
% Otherwise, returns a coder.CodeConfig object.

创建一个代码生成配置对象，以生成独立 C 动态库。

cfg = coder.config('dll')
% Returns a coder.EmbeddedCodeConfig object if the Embedded 
% Coder product is installed. 
% Otherwise, returns a coder.CodeConfig object.

创建一个代码生成配置对象，以生成独立 C 可执行文件。

cfg = coder.config('exe')
% Returns a coder.EmbeddedCodeConfig object if the Embedded 
% Coder product is installed. 
% Otherwise, returns a coder.CodeConfig object.

即使您的系统上安装了 Embedded Coder® 产品，也要创建一个 coder.CodeConfig 对象。

cfg = coder.config('lib','ecoder',false)

在没有 Embedded Coder 的情况下创建 coder.EmbeddedCodeConfig 对象。

cfg = coder.config('lib','ecoder',true)

创建一个 coder.FixPtConfig 对象。

fixptcfg = coder.config('fixpt');

创建一个 coder.SingleConfig (Fixed-Point Designer) 对象。

scfg = coder.config('single');

输入参数

全部折叠

配置对象类型生成的代码代码生成配置对象（已安装 Embedded Coder）代码生成配置对象（未安装 Embedded Coder）
'mex'MEX 函数coder.MexCodeConfigcoder.MexCodeConfig
'lib'静态库coder.EmbeddedCodeConfigcoder.CodeConfig
'dll'动态库coder.EmbeddedCodeConfigcoder.CodeConfig
'exe'可执行文件coder.EmbeddedCodeConfigcoder.CodeConfig

示例: coder.config('mex');

数据类型: char | string

'fixpt'

创建一个 coder.FixptConfig 配置对象，以便在从浮点 MATLAB 代码生成定点 MATLAB 或 C/C++ 代码时与 codegen 结合使用。

'single'

创建一个 coder.SingleConfig 配置对象，以便在从双精度 MATLAB 代码生成单精度 MATLAB 代码时与 codegen 结合使用。

示例: coder.config('fixpt');

数据类型: char | string

true

不管 Embedded Coder 是否存在，都创建 coder.EmbeddedCodeConfig 配置对象以允许使用以下功能：

  • 通过执行软件在环 (SIL) 和处理器在环 (PIL) 来验证代码。

  • 代码追溯或双向可追溯性。

  • 硬件特定优化和自定义替换库。

  • 自定义生成的代码的外观

请参阅从 MATLAB 代码中生成代码的 Embedded Coder 功能 (Embedded Coder)。

build_type 必须是 'lib'、'dll' 或 'exe'。

但是，使用 coder.EmbeddedCodeConfig 对象生成代码需要 Embedded Coder 产品。

false创建一个 coder.CodeConfig 配置对象，即使安装了 Embedded Coder 产品也是如此。build_type 必须为 'lib'、'dll' 或 'exe'。

示例: coder.config('lib','ecoder',false);

数据类型: logical

输出参量

全部折叠

MATLAB Coder™ 代码生成配置对象的句柄。

替代方法

使用 coder 函数打开 MATLAB Coder，并创建一个 MATLAB Coder 工程。该 App 提供了用户界面，便于您添加 MATLAB 文件、定义输入参数和指定编译参数。

版本历史记录

在 R2011a 中推出

另请参阅

| | | | | (Fixed-Point Designer)

主题