MISRA C:2025 Rule 8.5
R2026b描述
An external object or function shall be declared once in one and only one file 1 .
理由
通过在头文件中声明标识符,您可以在定义或使用该标识符的任何翻译单元中包含该头文件。在头文件中将声明模块化有助于保持以下方面之间的一致性:
声明与定义。
不同翻译单元中的声明。
此规则强制执行在头文件中声明外部对象或函数的做法。
Polyspace 实现
规则检查项会检查显式和隐式的 extern 声明(忽略暂定的定义)。检查项会标记以下变量或函数:
在非头文件中声明为
extern的变量或函数被多次声明的变量或函数,例如,在头文件和非头文件中各声明一次。
此检查项会:
忽略编译器特定的、不可移植的函数声明覆盖方式,例如
pragma weak或__attribute__((weak))。忽略代码中未使用的 typedef 和函数声明。
将重声明视为违规。例如,如果您在代码中声明了一个弱符号,之后又重声明该符号,Polyspace® 会报告违规。如果您不想修复此类违规,可以在结果或代码中添加注释,以避免再次被审查。请参阅:
Address Polyspace Results Through Bug Fixes or Justifications(如果在 Polyspace 用户界面中审查结果)。
通过 Bug 修复或申述在 Polyspace Access 中处理结果 (Polyspace Access)(如果在 Web 浏览器中审查结果)。
故障排除
如果您预期会出现违规,但未看到该违规,请参阅诊断为何编码规范违规未按预期显示。
示例
检查信息
| 组:声明和定义 |
| 类别:必需 |
| AGC 类别:必需 |
PQL 名称:std.misra_c_2025.R8_5
|
版本历史记录
在 R2026b 中推出
1 All MISRA coding rules and directives are © Copyright The MISRA Consortium Limited 2021.
The MISRA coding standards referenced in the Polyspace Bug Finder™ documentation are from the following MISRA standards:
MISRA C:2004
MISRA C:2012
MISRA C:2023
MISRA C:2025
MISRA C++:2008
MISRA C++:2023
MISRA and MISRA C are registered trademarks of The MISRA Consortium Limited 2021.