主要内容

共享实用工具标识符格式

R2026b

自定义共享实用工具标识符

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

描述

自定义共享实用工具标识符。

依赖关系

此参数:

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

  • 仅对 C++ 和 AUTOSAR 代码生成显示。

  • 生成代码时需要 Embedded Coder®。

设置

$N$C (默认) | 字符串

自定义生成的共享实用工具标识符名称。

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

标记描述
$N

插入为其生成共享实用工具标识符的对象的系统生成名称。可选。

$C

当未指定 $N 或最大标识符长度不足以容纳 $N 的完整长度时,插入八个字符的条件校验和。使用共享校验和长度参数修改校验和字符长度。必需。

$R

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

$U

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

提示

  • 尽可能增大最大标识符长度以容纳您期望生成的标识符的长度。

  • 校验和标记 $C 是必需的。如果在未指定 $N 或 $R 的情况下指定 $C,则校验和包含在标识符名称中。否则,代码生成器仅在必要时包含校验和以防止名称冲突。

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

  • 如果您指定 $N 或 $R,则仅当标识符长度太短而无法容纳完全展开的格式文本时,校验和才包含在标识符名称中。代码生成器包含校验和并截断 $N 或 $R,直到长度等于最大标识符长度。必要时插入下划线以分隔标记。

  • 如果您指定 $N 和 $R,则仅当标识符长度太短而无法容纳完全展开的格式文本时,校验和才包含在标识符名称中。代码生成器包含校验和并截断 $N,如果需要,还截断 $R,直到长度等于最大标识符长度。必要时插入下划线以分隔标记。

  • 描述性文本有助于使标识符名称更易于访问。

  • 对于 R2016a 之前的版本,共享实用工具标识符格式参数不支持 $R 标记。对于模型,如果共享实用工具标识符格式参数包含 $R 标记,并且您将模型导出到 R2016a 之前的版本,则共享实用工具标识符格式参数默认为 $N$C。

  • 对于 C 代码生成,使用 Embedded Coder 字典创建一个指定命名规则的函数自定义模板,然后使用代码映射编辑器应用该模板。

推荐的设置

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

编程用法

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

版本历史记录

在 R2013b 中推出