本页对应的英文页面已更新,但尚未翻译。 若要查看最新内容,请点击此处访问英文页面。

coder.config

创建 MATLAB Coder 代码生成配置对象

说明

示例

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_flagtrue 还是 false 创建 coder.EmbeddedCodeConfig 对象或 coder.CodeConfig 对象。build_type'lib''dll''exe'

示例

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™。

示例

全部折叠

从 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 配置对象。但是,使用 coder.EmbeddedCodeConfig 对象生成代码需要 Embedded Coder 产品。build_type 必须为 'lib''dll''exe'
false创建一个 coder.CodeConfig 配置对象,即使安装了 Embedded Coder 产品也是如此。build_type 必须为 'lib''dll''exe'

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

数据类型: logical

输出参数

全部折叠

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

替代方法

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

在 R2011a 中推出