Main Content

常量宏

自定义生成的常量宏标识符

模型配置窗格: 代码生成 / 标识符

描述

自定义生成的常量宏标识符。

依存关系

此参数:

  • 仅对基于 ERT 的目标显示。

  • 生成代码时需要 Embedded Coder®

设置

$R$N$M (默认) | 字符串

输入一个宏,该宏指定某些文本是否以及以何种顺序包含在生成的标识符中。该宏可以包含以下格式标记的组合。

标记描述
$M

如果需要,插入名称修饰文本以避免名称冲突。

必需。

$N

插入正在为其生成标识符的对象(模块、信号或信号对象、状态、参数或参数对象)的名称。

$R

将根模型名称插入标识符中,用下划线 (_) 字符替换不支持的字符。

对模型引用是必需的。

$U

插入您为 $U 标记指定的文本。使用自定义标记文本参数指定此文本。

提示

  • 通常要避免名称冲突。一种方法是在您的模型有许多相同类型的模块时避免使用默认模块名称(例如 Gain1Gain2...)。

  • 尽可能增大最大标识符长度以容纳您期望生成的标识符的长度。至少保留三个字符用于名称修饰文本。

  • 要控制每个标记所表示的文本的大小写(大写或小写),请在宏中包含修饰符,如 [U_]。请参阅Control Case of Identifiers by Using Basic Token Decorators

  • 如果指定 $R,则为最大标识符长度指定的值必须足够大,以容纳 $R$M 标记的完全扩展。

  • 当更高层级的模型作用域内的标识符与引用模型作用域内的标识符之间发生名称冲突时,代码生成器会保留引用模型中的标识符。对更高层级的模型中的标识符执行名称修饰。

  • 此选项不影响存储类不是 Auto(如 ImportedExternExportedGlobal)的对象(如信号和参数)。

  • 对于引用模型,如果常量宏参数不包含 $R 标记(表示引用模型的名称),代码生成会将 $R 标记追加到标识符格式的前面。

    您可以使用模型顾问来标识模型引用层次结构中代码生成为其更改配置参数设置的模型。

    1. 建模选项卡上,选择模型顾问

    2. 选择按任务

    3. 运行检查用于模型引用的代码生成标识符格式检查。

推荐的设置

应用场景设置
调试无影响
可追溯性使用默认值
效率无影响
安全预警无建议

编程用法

参数:CustomSymbolStrMacro
类型:字符向量
值:标记的有效组合
默认值:$R$N$M

版本历史记录

在 R2006b 中推出