主要内容

编码器。CodeConfig

C / C ++代码生成的配置参数马铃薯代码

描述

一个编码器。CodeConfig对象包含配置参数codegen用于生成静态库、动态链接库或可执行程序。将对象传递给codegen函数的配置选择。

创建

描述

例子

cfg = coder.config(build_type.为指定的构建类型创建代码生成配置对象,该类型可以是静态库、动态链接库或可执行程序。如果嵌入式编码器®产品没有安装,它创建一个编码器。CodeConfig对象。否则,它将创建编码器。EmbeddedCodeConfig对象。

cfg = coder.config(build_type.“是”,假)创造一个编码器。CodeConfig对象的指定输出类型,即使已安装Embedded Coder。

输入参数

全部展开

从生成的C/ c++代码构建的输出,指定为该表中的值之一。

价值 描述
“自由” 静态库
“DLL” 动态链接库
EXE” 可执行程序

属性

全部展开

编译器优化或Toolchain的调试设置,指定为此表中的值之一。

价值 描述
“加快构建”

优化构建以获得更短的构建时间。

“快跑”

为更快的运行可执行文件进行优化构建。

“调试”

优化构建以进行调试。

'指定'

使CustomToolchainOptions用于自定义所选工具链中工具的设置的属性。如果是工具链属性设置为“自动定位安装的工具链”,然后设置BuildConfiguration.'指定'变化工具链到所定位的工具链。

代码替换库生成的代码,指定为表中的值之一:

价值 描述
“没有”

此值为默认值。

不使用代码替换库。

命名代码替换库

生成对特定平台、编译器或标准代码替换库的调用。命名库的列表取决于:

  • 安装包的支持。万博1manbetx

  • 系统目标文件,语言,标准数学库和设备供应商配置。

  • 是否使用Embedded Coder产品创建和注册代码替换库。

兼容库依赖于以下参数:

  • TargetLang

  • Targetlangstandard.

  • ProdHWDeviceType在硬件实现配置对象中。

Embedded Coder提供了更多的库以及创建和使用自定义代码替换库的能力。

马铃薯®编码器™生成最小的一组# include所选代码替换库所需的头文件的语句。

在设置此参数之前,请验证您的编译器是否支持要使用的库。万博1manbetx如果选择编译器不支持的参数值,则可能会发生编译器错误。万博1manbetx

请注意

Matlab编码器软件不支持TLC回调。万博1manbetx

编译时递归的函数专门化的最大数目,指定为正整数。要在MATLAB代码中禁用递归,请设置compiletimerecursionlimit.为0。对于大多数需要这种递归的递归函数来说,默认的编译时递归限制是足够大的。如果由于编译时递归限制而导致代码生成失败,而您想要编译时递归,请尝试增加限制。或者,更改MATLAB代码,使代码生成器使用运行时递归。看到达到编译时间递归限制

常量文件夹执行的最大指令数。在某些情况下,代码生成需要特定指令常量。如果在这些指令常量折叠之前的常量折叠停止,则代码生成失败。在这种情况下,增加值ConstantFoldingTimeout

看到生成代码中的MATLAB编码器优化

生成C ++代码时接口类的名称CppInterfaceStyle设置“方法”.在这种情况下,MATLAB入门点函数的生成代码由C ++类中包含的方法组成,其中名称指定CppInterfaceClassName.此属性设置时无效CppInterfaceStyle'功能'

看到用类接口生成c++代码

为您生成代码的MATLAB入口点函数生成的c++代码的接口风格。默认情况下,入口点函数变成c++函数。如果你选择“方法”然后,入口点函数成为C ++类中的方法。使用该属性指定类的名称CppInterfaceClassName

看到用类接口生成c++代码

依赖性:

  • 设置TargetLang'c ++'启用此参数。

是否为MATLAB代码中的包生成C ++命名空间,指定为此表中的值之一。

价值 描述
真的

此值为默认值。

代码生成器为Matlab代码中的包生成C ++命名空间。看到将生成的c++代码组织到命名空间中

错误的

代码生成器不会为MATLAB代码中的包生成C ++命名空间。

依赖性:

  • 设置TargetLang'c ++'启用此参数。

数据类型:逻辑

生成的c++代码的名称空间。除非指定非空字符向量,否则代码生成器不会在名称空间中生成代码。

看到将生成的c++代码组织到命名空间中

依赖性:

  • 设置TargetLang'c ++'启用此参数。

为MathWorks代码生成的c++代码的名称空间。如果您将该属性指定为空字符向量,则代码生成器不会生成这样的名称空间。

看到将生成的c++代码组织到命名空间中

依赖性:

  • 设置TargetLang'c ++'启用此参数。

数据类型:char

是否生成MATLAB类的C ++类或C样式结构,指定为此表中的值之一。

价值 描述
真的

此值为默认值。

代码生成器为MATLAB类生成c++类。看到为MATLAB类生成c++类

错误的

代码生成器为MATLAB类生成C风格的结构。

依赖性:

  • 设置TargetLang'c ++'启用此参数。

数据类型:逻辑

BLAS库的回调类呼叫在MATLAB代码中为某些低级向量和MATLIX操作中生成的代码,指定为字符向量。

如果为某些低级向量和矩阵函数指定BLAS回调类,则代码生成器通过使用BLAS库的CBLAS C接口产生BLAS调用。回调类提供CBLAS头文件的名称,CBLAS数据类型的名称以及链接到BLAS库所需的信息。如果此参数为空,则代码生成器会为矩阵函数而不是BLAS调用产生代码。

看到通过使用BLAS调用加速生成的独立代码中的矩阵运算

FFTW库的回调类呼叫在MATLAB代码中为FFT函数生成的代码,指定为字符向量。

为了提高FFT函数的执行速度,代码生成器生成对您在回调类中指定的FFTW库的调用。如果该参数为空,代码生成器将使用自己的FFT函数算法,而不是调用FFTW库。

看到使用FFTW库调用加快生成的独立代码中的快速傅里叶变换

除了从MATLAB代码生成的每个C / C ++头文件附近的自定义代码,除了RTWTYPES.H.RTWHALF.H.,指定为字符向量。

在编译生成的代码时,包括要添加到Include路径的文件夹。将包含文件夹列表指定为字符向量。在字符向量中,用aPathsep.的性格。例如:

cfg = coder.config(‘自由’,‘是’,假);cfg。CustomInclude = ['C:\项目'路径sep 'C:\自定义文件'];

要包含在生成的初始化函数中的自定义代码,指定为字符向量。

在MATLAB代码中为某些线性代数函数生成的代码中的LAPACK库调用的回调类,指定为字符向量。

如果为某些线性代数函数指定Lapack回调类,则代码生成器通过使用Lapacke C接口到Lapack库来产生Lapack呼叫。Callback类提供了Lapacke头文件的名称以及链接到Lapack库所需的信息。如果此参数为空,则代码生成器会为线性代数函数而不是lapack呼叫生成代码。

看到通过使用LAPACK调用加速独立代码中的线性代数

静态库文件链接生成的代码,指定为字符向量。在字符向量中,用aPathsep.的性格。

源文件编译和链接生成的代码,指定为字符向量。在字符向量中,单独的源文件名Pathsep.的性格。

构建过程首先在当前文件夹中搜索源文件,然后在您指定的包含文件夹中搜索CustomInclude.如果在搜索路径上的多个文件夹中出现具有相同名称的源文件,则构建过程可能会使用不同的文件,而不是您指定的文件。

假设你指定foo.cpp.作为源文件。如果Foo.c.foo.cpp.都在搜索路径上,您无法确定构建过程是否使用Foo.c.要么foo.cpp.

指定代码显示在生成的每个代码的顶部附近.c要么.cpp.文件(除了RTWHALF.C.要么rtwhalf.cpp),在任何函数之外。将代码指定为字符向量。

不要指定C静态函数定义。

在生成的终止功能中显示的代码,指定为字符向量。

在选定的工具链中自定义工具的设置,指定为单元格数组。

依赖性:

  • 工具链属性确定在单元格数组中出现哪些工具和选项。

  • 设置BuildConfiguration.财产指定启用CustomToolchainOptions

首先,获取当前设置。例如:

cfg = coder.config(“自由”);cfg。BuildConfiguration ='指定';选择= cfg。CustomToolchainOptions

然后,编辑其中的值选择

这些值来自工具链定义文件和第三方编译器选项。看到自定义工具链登记

数据类型在生成的代码中替换,指定为此表中的值之一。

价值 描述
“CBuiltIn”

此值为默认值。

代码生成器使用内置的C数据类型。

'codertypedefs' 代码生成器使用预定义的数据类型RTWTYPES.H.

用于深度学习网络代码生成的配置对象,指定为编码器。MklDNNConfig对象或一个编码器。一个RMNEONConfig对象。

一个编码器。MklDNNConfig对象包含特定于C ++代码生成的参数,用于使用英特尔深度学习®MKL-DNN。创建一个编码器。MklDNNConfig对象,使用coder.deeplearningconfig.例如:

cfg = coder.config(墨西哥人的);cfg.targetlang =.'c ++';cfg。DeepLearningConfig =编码器。DeepLearningConfig ('mkldnn');

一个编码器。一个RMNEONConfig对象包含特定于使用ARM进行深度学习的c++代码生成的参数®计算库。创建一个编码器。一个RMNEONConfig对象,使用coder.deeplearningconfig.例如:

cfg = coder.config(“自由”);cfg.targetlang =.'c ++';cfg。DeepLearningConfig =编码器。DeepLearningConfig (“arm-compute”);

深度学习网络的代码生成需要deep learning Toolbox™和深度学习库的MATLAB编码器接口万博1manbetx支持包。

看到MKL-DNN的深度学习网络代码生成基于ARM计算库的深度学习网络代码生成

依赖:如果DeepLearningConfig设置了,codegenTargetLangc++

对象描述,指定为字符向量。

动态内存分配模式,指定为此表中的值之一。

价值 描述
“阈值”

此值为默认值。

代码生成器在变量大小阵列的堆上动态分配内存,其大小(以字节为单位)大于或等于DynamicMemoryallocationThreshold.

“AllVariableSizeArrays” 代码生成器动态地为堆上所有大小可变的数组分配内存。
'离开'

代码生成器静态分配堆栈上可变大小阵列的内存。

无界可变大小数组需要动态内存分配。

依赖性:

  • 促进variazing.启用此参数。

  • 设置这一点DynamicMemoryallocation.“阈值”使DynamicMemoryallocationThreshold.范围。

看到生成可变大小数据的代码

在生成的C / C ++函数的接口处实现动态分配的数组,指定为此表中的值之一。

价值 描述
“汽车”

这是默认值。如果你设置了TargetLang参数到'c ++'要么'C',此值相应地表现为相同的选项。

'C'

生成的代码使用C样式emxArray实现动态分配数组的数据结构。看到在生成的函数接口中使用C数组

'c ++'

如果你设置了TargetLang参数到'C',则禁用此值。

否则,生成的代码使用编码器:: Array.类模板来实现动态分配的数组。看到在生成的函数接口中使用动态分配的C ++数组

依赖性:

  • 促进variazing.启用此参数。

可变大小数组的动态内存分配的大小阈值,指定为正整数。代码生成器对大小(以字节为单位)大于或等于阈值的可变大小数组使用动态内存分配。

依赖性:

  • 设置DynamicMemoryallocation.“阈值”启用此参数。

看到生成可变大小数据的代码

自动外部函数调用,指定为表中的值之一。

价值 描述
真的

此值为默认值。

代码生成器将一些常见的可视化函数视为外部函数。你不需要通过使用声明这些函数为外部函数coder.extrinsic.此功能减少了您用于使代码适合于代码生成的时间。

错误的 除非您通过使用将它们声明为外在功能,否则代码生成器不会将公共可视化功能视为外部函数coder.extrinsic

一些常见的可视化函数是阴谋disp, 和数字.看到外在功能

memcpy优化,指定为此表中的值之一。

价值 描述
真的

此值为默认值。

如果可能,代码生成器使用memcpy优化。优化复制连续数组元素的代码,memcpy优化将代码替换为memcpy调用。当在编译时知道要复制的元素数量时,代码生成器使用MemcyThreshold.属性以确定是否使用该优化。看到MEMCPY优化

错误的

代码生成器不使用memcpy优化。

并行化的parfor-loops,指定为该表中的一个值。

价值 描述
真的

此值为默认值。

如果可能的话,代码生成器使用OpenMP库生成并行运行的循环迭代。

错误的

代码生成器处理parfor循环,为了- 砍伐。

看到parfor

OpenMP库的使用与即时(JIT)编译不兼容。如果EnableJITEnableOpenmp.真的,代码生成器使用JIT编译和治疗parfor循环,为了- 砍伐。

运行时递归支持,指定为该表中的值之一。万博1manbetx

价值 描述
真的

此值为默认值。

生成的代码中允许递归函数。

错误的

生成的代码中不允许使用递归函数。

一些编码标准,例如Misra®,不允许递归。增加生成符合Misra C的代码的可能性®,设置EnableRuntimeRecursion错误的

如果你的MATLAB代码需要运行时递归和EnableRuntimeRecursion错误的,代码生成失败。

看到递归函数的代码生成

支持可变大小数组,指定为该表中的值之一。万博1manbetx

价值 描述
真的

此值为默认值。

代码生成允许可变大小的阵列。

错误的

不允许使用可变大小的数组生成代码。

依赖性:

  • 使动态内存分配

看到可变大小阵列的代码生成

文件分区模式指定为此表中的值之一。

价值 描述
'mapmfiletocfile'

此值为默认值。

代码生成器为每个MATLAB语言文件生成单独的C / C ++文件。

'singlefile' 代码生成器为映射到MATLAB入口点函数的C/ c++函数生成一个文件。代码生成器为实用函数生成单独的C/ c++文件。

看到MATLAB编码器如何划分生成的代码

仅生成源代码,指定为该表中的值之一。

价值 描述
错误的

此值为默认值。

代码生成器生成C/ c++源代码并构建目标代码。

真的

代码生成器生成C/ c++源代码,但不调用make命令或构建对象代码。当您在修改MATLAB代码和生成C/ c++代码之间进行迭代时,只生成代码可以节省时间。

生成代码中的注释,指定为该表中的值之一。

价值 描述
真的

此值为默认值。

代码生成器在生成的代码中放置注释。

错误的 代码生成器不会在生成的代码中放置注释。

例C/ c++主文件生成,指定为表中值之一。

价值 描述
'generatocodeonly'

此值为默认值。

代码生成器生成一个示例C/ c++ main函数,但不编译它。

'donot geanerate'

代码生成器不会生成一个示例C/ c++主函数。

“GenerateCodeAndCompile”

代码生成器生成一个示例C/ c++ main函数,并编译它以创建一个测试可执行文件。此可执行文件不返回输出。

如果是GenCodeOnly参数是真的,代码生成器不编译C / C ++主函数。

示例主函数是一个模板,可以帮助您编写C / C ++主函数,调用生成的C / C ++代码。看到使用示例主函数并入生成的代码

在构建过程中生成Makefile,指定为该表中的值之一。

价值 描述
真的

此值为默认值。

代码生成器在构建过程中生成Makefile。

错误的 代码生成器在构建过程中不会生成makefile。在后代码生成命令中指定代码代码生成处理的说明,包括编译和链接。看到构建过程定制

生成非小型数据的支持文件,指万博1manbetx定为此表中的值之一。

价值 描述
真的

此值为默认值。

代码生成器为非有限数据生成支持文件(万博1manbetx),仅当生成的代码使用非有限数据时。

错误的

代码生成器总是为非有限数据生成支持文件(万博1manbetx)。

依赖性:

  • 设置万博1manbetxSupportNonFinite真的启用此参数。

代码生成报告,指定为该表中的值之一。

价值 描述
错误的

此值为默认值。

代码生成器仅在出现错误或警告消息或设置LaunchReport真的

真的 代码生成器生成代码生成报告。

指定硬件板的对象。创建编码器。硬件对象,使用coder.hardware.例如:

cfg = coder.config('lib');hw = coder.hardware('raspberry pi');cfg.hardware = hw;

使用之前coder.hardware,必须安装硬件的支持包。万博1manbetx

依赖性:

  • 设置硬件为特定硬件板自定义硬件实现对象和其他配置参数。

  • 如果DeepLearningConfig被设置为一个编码器。一个RMNEONConfig对象和硬件是空的,然后codegen设置GenCodeOnly财产真的

笔记:

  • 假设你创造了一个编码器。CodeConfig对象cfg并在另一个MATLAB会话中使用它。如果MATLAB主机对于第二次会话没有指定的硬件板cfg。硬件该参数安装在其上的属性恢复到其默认值。默认值是[]

硬件实现对象,用于指定C / C ++代码生成的硬件特定配置参数。Coder.config.创造一个编码器。CodeConfig对象与之HardwareImplementation属性设置为编码器.Hardwareimplementation.对象具有MATLAB主机的默认参数值。

为了防止由于包含多个头文件而导致的编译错误,代码生成器只生成一个头文件#如果未定义要么# pragma一旦在生成的头文件中的构造。如果项目使用使用相同预处理器宏的不同文件,则使用# pragma一旦构造。的编译行为# pragma一旦不是标准化的。

指定Headerguardstyle.作为表中的值之一。

价值 描述
umermcludeguard.

代码生成器会产生#如果未定义风格# include守卫。

UsePragmaOnce 代码生成器会产生# pragma一旦风格# include守卫。

显示潜在的行主布局效率问题,指定为该表中的值之一。

价值 描述
真的

代码生成报告显示了由于行主布局造成的潜在效率问题。(此值为默认值。)

错误的 代码生成报告不会显示与数组布局相关的问题。

看到行主要数组布局的代码设计

赋值float和double zeroMemset.,指定为此表中的值之一。

价值 描述
真的

此值为默认值。

如果可能,代码生成器使用Memset.优化浮点零分配给连续数组元素。分配连续数组元素,Memset.优化使用A.Memset.调用。当在编译时知道要分配的元素数量时,代码生成器使用MemcyThreshold.属性以确定是否使用该优化。看到MEMSET优化

错误的

代码生成器不使用Memset.浮点数和双零赋值给连续数组元素的优化。

在MathWorks调用其他MathWorks函数的所有呼叫网站上的内联行为,指定为此表中的值之一。

价值 描述
“速度”

此值为默认值。

使用内部试探法确定是否在调用站点执行内联。这种设置通常会导致高度优化的代码。

'总是'

始终在呼叫站点执行内联。

“可读性”

几乎从不内联函数调用,除非调用非常小的函数。尽可能保持代码的模块化,而不牺牲太多的速度。结果是高可读性的代码。

'绝不'

永远不要内联函数调用。导致最大的可读性。此设置可能会显著降低生成代码的性能。

即使你选择了'总是'或者'绝不'在某些情况下,选择的选项,代码生成器可能不会严格遵循该指令。例如,如果存在冲突,编码器.inline('总是')要么coder.inline(“不”)置于函数体内的指令将重写此选项。有关更多信息,请参见不同内联控制之间的互动

看到控制与生成代码的微调性能和可读性的联系

在所有呼叫网站上的内联行为,其中写入MathWorks函数的函数,或MathWorks函数调用您写入的函数。指定为此表中的值之一。

价值 描述
“速度”

此值为默认值。

使用内部试探法确定是否在调用站点执行内联。这种设置通常会导致高度优化的代码。

'总是'

始终在呼叫站点执行内联。

“可读性”

几乎从不内联函数调用,除非调用非常小的函数。尽可能保持代码的模块化,而不牺牲太多的速度。结果是高可读性的代码。

'绝不'

永远不要内联函数调用。导致最大的可读性。此设置可能会显著降低生成代码的性能。

即使你选择了'总是'或者'绝不'在某些情况下,选择的选项,代码生成器可能不会严格遵循该指令。例如,如果存在冲突,编码器.inline('总是')要么coder.inline(“不”)置于函数体内的指令将重写此选项。有关更多信息,请参见不同内联控制之间的互动

看到控制与生成代码的微调性能和可读性的联系

在你写的函数调用你写的另一个函数的所有调用站点上的内联行为,指定为表中的值之一。

价值 描述
“速度”

此值为默认值。

使用内部试探法确定是否在调用站点执行内联。这种设置通常会导致高度优化的代码。

'总是'

始终在呼叫站点执行内联。

“可读性”

几乎从不内联函数调用,除非调用非常小的函数。尽可能保持代码的模块化,而不牺牲太多的速度。结果是高可读性的代码。

'绝不'

永远不要内联函数调用。导致最大的可读性。此设置可能会显著降低生成代码的性能。

即使你选择了'总是'或者'绝不'在某些情况下,选择的选项,代码生成器可能不会严格遵循该指令。例如,如果存在冲突,编码器.inline('总是')要么coder.inline(“不”)置于函数体内的指令将重写此选项。有关更多信息,请参见不同内联控制之间的互动

看到控制与生成代码的微调性能和可读性的联系

自动打开代码生成报告,指定为本表中的值之一。

价值 描述
错误的

此值为默认值。

如果发生错误或警告,或者如果GenerateReport.真的,代码生成器生成报告,但不打开报告。

真的 代码生成器生成并打开代码生成报告。

迭代次数少于此阈值的循环可以由代码生成器自动展开。这个阈值适用于所有人为了- 在您的MATLAB代码中。对于个人为了循环,编码器在循环优先于循环展开优化之前立即放置的指令。阈值也可以适用于一些为了- 在代码生成期间产生的额。

看到展开for循环

将MATLAB源代码作为注释包含在生成的代码中,指定为表中的值之一。

价值 描述
错误的

此值为默认值。

代码生成器不会在生成的代码中插入MATLAB源代码作为注释。代码生成器在函数横幅中不包含MATLAB函数签名。

真的

代码生成器将MATLAB源代码作为注释插入生成的代码中。可跟踪性标记紧跟在每一行源代码的前面。跟踪标签帮助您定位相应的MATLAB源代码。看到跟踪生成的C/ c++代码到MATLAB源代码

如果您有Embedded Coder,在代码生成报告中,跟踪标记将链接到源代码。

代码生成器还在函数横幅中包含MATLAB函数签名。

依赖性:

  • GenerateComments启用此参数。

看到跟踪生成的C/ c++代码到MATLAB源代码

生成标识符中的最大字符数,指定为范围的正整数[31,2048]。此属性适用于生成的函数,类型定义和变量名称。为避免目标C / C ++编译器截断标识符,请指定与目标C / C ++编译器的最大标识符长度匹配的值。

该属性不适用于导出的标识符,例如为入口点函数或emxArray API函数生成的名称。如果导出的标识符的长度超过目标C编译器的最大标识符长度,目标C/ c++编译器将截断导出的标识符。

默认值:

  • 如果TargetLang被设置为'C'的默认值MaxIdLength31

  • 如果TargetLang被设置为'c ++'的默认值MaxIdLength1024

memcpy或memset优化所需的最小大小(以字节为单位),指定为正整数。

要优化复制连续数组元素的生成的代码,代码生成器试图用一个替换代码memcpy调用。为了优化为连续数组元素分配文字常量的生成代码,代码生成器尝试用Memset.调用。

字节数是要复制或分配乘以C / C ++数据类型所需的字节数的数组元素的数量。

如果要复制或赋值的元素数量是可变的(在编译时不知道),则代码生成器将忽略MemcyThreshold.财产。

看到MEMCPY优化MEMSET优化

多实例,重新输入代码,指定为此表中的值之一。

价值 描述
错误的

此值为默认值。

代码生成器不会生成多实例的重码代码。

真的

代码生成器生成可重用的、可重入的多实例代码。

看到可重入代码.GPU Coder™产品不支持此选项。万博1manbetx

对象名称,指定为字符向量。

从生成的C/ c++代码构建的输出,指定为该表中的值之一。

价值 描述
“自由” 静态库
“DLL” 动态链接库
EXE” 可执行程序

通过参考入口点函数传递结构,指定为此表中的值之一。

价值 描述
真的

此值为默认值。

生成的代码通过引用传递结构,通过最小化入口点函数边界上参数的副本数量来减少内存使用和执行时间。

请注意

写入结构参数字段的入口点函数将重写输入值。

错误的 生成的代码按值传递结构。

此参数仅适用于入口点函数。

GPU编码器总是设置PassstructByReference.属性为true。

看到通过引用或通过生成的代码中的值传递结构参数

命令以在MEX功能生成后自定义构建处理codegen,指定为字符向量。

看到构建过程定制

生成使用n维索引的代码,指定为此表中的值之一。

价值 描述
错误的

生成使用一维索引的代码。(此值为默认值。)

真的 生成使用n维索索引的代码。

看到生成使用n维索引的代码

变量名称要保存在生成​​的代码中,指定为此表中的值之一。

价值 描述
“没有”

此值为默认值。

代码生成器不需要保留任何变量名。它可以重用任何满足变量重用要求的变量。

如果您的代码使用大型结构或数组,则设置preservevariamblenames.“没有”可以减少内存使用或提高执行速度。

“用户名”

代码生成器保留与您在MATLAB代码中定义的变量对应的名称。它不会将变量名替换为另一个名称,也不会将您的名称用于另一个变量。为了提高可读性,设置preservevariamblenames.“用户名”.然后,您可以更轻松地将生成的代码中的变量追踪回MATLAB代码中的变量。

设置preservevariamblenames.“用户名”不会阻止优化从生成的代码中删除变量,或阻止C / C ++编译器重用生成的二进制代码中的变量。

“所有”

保留所有变量名。此参数值禁止变量重用。它只用于测试或调试,而不是用于生产代码。

看到在生成的代码中保留变量名称

将有关代码生成的信息导出到其上的变量的名称,指定为字符向量。代码生成器在基本的MATLAB工作空间中创建这个变量。此变量包含有关代码生成设置、输入文件、生成文件和代码生成消息的信息。

看到以编程方式访问代码生成报告信息编码器。ReportInfo属性

电位差报告,指定为表中值之一:

价值 描述
真的 代码生成器报告生成的代码和MATLAB代码之间的潜在行为差异。潜在的差异列在代码生成报告的一个选项卡上。电位差是在运行时仅在某些条件下发生的差值。
错误的 代码生成器不会报告潜在的差异。

看到潜在的差异报告

代码生成器不能对函数或变量使用的名称列表,指定为字符向量或字符串标量。要指定多个保留名称,请使用分号分隔的保留名称列表reasurednameArray..例如,cfg。ReservedNameArray = " reserve1; reserve2 reserve3”

生成使用行主数组布局的代码,指定为该表中的值之一。

价值 描述
错误的

生成使用列主数组布局的代码。(此值为默认值。)

真的 生成使用行主要数组布局的代码。

看到生成使用行主数组布局的代码

在生成的入口点函数的开始处生成对初始化函数的调用,指定为该表中的值之一。

价值 描述
真的

此值为默认值。

在生成的入口点函数的开头包含对初始化函数的调用。生成的代码包括检查,以确保初始化函数只被调用一次,即使有多个入口点函数。

错误的

生成的入口点函数不包括对初始化函数的调用。

看到使用生成的初始化和终止函数

依赖性:

  • 设置multipstancecode.真的禁用这个参数。

在生成的代码中进行运行时错误检测和报告,指定为该表中的值之一。

价值 描述
错误的

此值为默认值。

生成的代码不会检查诸如超出边界的数组索引之类的错误。

真的

生成的代码将检查诸如超出边界的数组索引之类的错误。

错误报告软件使用写入错误消息stderr.它使用中止终止应用程序。如果中止不可用,您必须提供它们。的中止函数突然终止程序。如果您的系统支持信号,您可以捕万博1manbetx获中止信号(SIGABRT)因此您可以控制程序终止。

错误消息是英文。

看到独立C / C ++代码中的运行时错误检测和报告

整数溢出支持,指定为该表中的一个值万博1manbetx。

价值 描述
真的

此值为默认值。

代码生成器生成处理整数溢出的代码。溢出会饱和到数据类型所能表示的最小值或最大值。

错误的

代码生成器不生成代码以处理整数溢出。没有设置SaturateOnIntegerOverflow错误的除非您确定您的代码不依赖于整数溢出支持。万博1manbetx如果禁用整数溢出支持并启用运行时错误检查,则生成的代码将产生溢出万博1manbetx错误。如果您禁用整数溢出支持并禁用运行时错误检查,溢出行为取决于您的目万博1manbetx标C编译器。在C标准中,整数溢出的行为是未定义的。然而,大多数C编译器都会在溢出时进行包装。

此参数仅适用于MATLAB内置整数类型。它不适用于双精度、单精度或定点数据类型。

看到禁用对整数溢出或万博1manbetx非小型的支持

每个应用程序的最大堆栈用法(以字节为单位)指定为正整数。设置低于可用堆栈大小的限制。否则,可能会发生运行时堆栈溢出。C编译器检测并报告堆栈溢出。

看到禁用对整数溢出或万博1manbetx非小型的支持

万博1manbetx支持非小型值,指定为此表中的值之一。

价值 描述
真的

此值为默认值。

如果GenerateNonFiniteFilesIfUsed被设置为真的,代码生成器生成支持非有限值的代码(万博1manbetx),除非他们被使用。

如果GenerateNonFiniteFilesIfUsed被设置为错误的,代码生成器总是生成支持非有限值的代码(万博1manbetx)。

错误的

代码生成器不生成支持非有限值的代码。万博1manbetx

看到禁用对整数溢出或万博1manbetx非小型的支持

用于生成代码的语言,指定为'C'要么'c ++'.如果指定C ++,则代码生成器将C代码包裹到.cpp文件中,以便您可以使用C ++编译器和与外部C ++应用程序的接口。它不会生成C ++类。

依赖:如果DeepLearningConfig设置了,codegenTargetLangc++

用于生成代码的标准数学库,指定为以下字符向量之一:

  • 'C89 / C90(ANSI)'

  • “C99 (ISO)”

  • “c++ 03 (ISO)”

  • 'C ++ 11(ISO)'

代码生成器使用标准数学库来调用数学操作。默认的标准数学库取决于您选择的语言。对于C语言,默认库是“C99 (ISO)”.对于c++,默认库是“c++ 03 (ISO)”

看到改变标准数学库

用于构建C/ c++库或可执行程序的工具链,指定为字符向量。可用工具链的列表取决于主机平台,可以包括您添加的自定义工具链。如果您没有指定工具链,代码生成器将定位已安装的工具链。

笔记:

  • 假设你创造了一个编码器。CodeConfig对象cfg并在另一个MATLAB会话中使用它。如果用于第二会话的MATLAB主机没有在中指定的工具链cfg.toolchain.该参数安装在其上的属性恢复到其默认值。默认值是“自动定位安装的工具链”

代码生成进度显示,指定为此表中的值之一。

价值 描述
错误的

此值为默认值。

代码生成器不显示代码生成进度。

真的

代码生成器显示代码生成过程,包括代码生成阶段和编译器输出。

例子

全部收缩

写一个可以从中生成代码的MATLAB函数。此示例使用该功能迈达德返回其输入的和。

函数myadd(a,b) = myadd(a,b);结束

创建一个配置对象来生成独立的C/ c++代码(静态库、动态链接库或可执行程序)。例如,为生成静态库创建配置对象。

cfg = coder.config(“自由”);

更改不希望使用默认值的属性值。例如,在生成的C/ c++代码中启用运行时错误检测和报告。

cfg。RuntimeChecks = true;

使用以下命令生成代码codegen.将配置对象传递给codegen通过使用配置选择。指定输入参数为标量双精度。

codegen迈达德配置cfgarg游戏{1}-报告

选择功能

使用生成类型的默认配置参数“自由”“DLL”,或EXE”,可以使用codegen选项-config:lib-Config:DLL.,或配置:exe,分别。然后,您不必创建并传递配置对象codegen

介绍了R2011a