检查 MISRA C++:2008 (-misra-cpp)
检查是否存在违反 MISRA C++ 规则的情形
描述
指定是否检查违反 MISRA™ C++:2008 规则的情形 1 .此选项的每个值对应一个要检查的规则子集。
设置选项
使用以下方法之一设置选项：
Polyspace® 用户界面（仅限桌面端产品）：在您的工程配置中，选择编码标准和代码度量节点，然后为此选项选择一个值。有关您必须先启用的其他选项，请参阅依赖关系。
Polyspace 平台用户界面（仅限桌面端产品）：工程配置中不存在此选项。通过
使用自定义检查项文件和检查项激活文件 (-checkers-activation-file)选项激活检查项。
为何使用此选项
使用此选项指定要检查的 MISRA C++ 规则子集。
分析完成后，结果列表窗格中会列出检测到的编码标准违规。在源窗格中，对于每项编码违规，Polyspace 都会为与该违规相关的关键字或标识符显示一个 
符号。
设置
默认值：required-rules
- required-rules
检查必需编码规则。
- all-rules
检查必需和建议编码规则。
- SQO-subset1
仅检查 MISRA C++ 规则的子集。有关详细信息，请参阅Software Quality Objective Subsets for MISRA Coding Standards。
- SQO-subset2
检查规则的子集，包括 SQO-subset1 以及某些附加规则。有关详细信息，请参阅Software Quality Objective Subsets for MISRA Coding Standards
- from-file
指定一个 XML 文件，您可以在其中针对此编码标准配置自定义检查项选择。要创建配置文件，请点击
，然后从检查项选择窗口的右侧窗格中，选择此编码标准中要检查的规则和建议。保存该文件。 要使用或更新某个现有配置文件，请在检查项选择窗口中，在提供的字段中输入该文件的完整路径，或者点击浏览。
如果您将选项设置为 from-file，请启用
使用文件设置检查项 (-checkers-selection-file)。
命令行信息
在命令行中使用 -misra-cpp 命令检查是否存在违反 MISRA C++ 规则的情形。
参数：-misra-cpp |
值：required-rules | all-rules | SQO-subset1 | SQO-subset2 | from-file |
示例 (Bug Finder)：polyspace-bug-finder -sources |
示例 (Bug Finder Server)：polyspace-bug-finder-server -sources |
或者，通过检查项激活 XML 文件来启用所有或特定 MISRA C++ 规则。请参阅检查项激活文件 (-checkers-activation-file)。
版本历史记录
从 R2019a 开始，用来自定义编码标准检查项选择的文件必须使用 XML 格式。为此目的使用文本格式会导致错误。您可以将 Polyspace 支持的所有编码标准的自定义选择保存到同一文件中。
桌面端界面：
如果您的工程包含采用文本格式的自定义编码标准选择文件，则 Polyspace 会自动更新这些文件并将其合并为单个 XML 文件。如果您的工程具有引用同一自定义选择文件的多个冲突配置，则该软件会将每个配置的合并编码标准选择保存到单独的 XML 文件中。
要手动将您的文本文件更新为 XML 格式，请在配置窗格的编码标准和代码度量节点中点击 
。在检查项选择窗口中，选择相应的文件并点击保存更改。Polyspace 会将这些文件合并为单个 XML 文件，并将此文件保存为 filename.xmlfilename 是按字母顺序排列的第一个选定文件的名称。例如，如果您选择 foo.conf 和 bar.conf，则它们将被保存为 bar.conf.xml。
命令行：
在命令行或 IDE 扩展中，使用文本文件作为 -misra-cpp 的输入会导致错误。要选择 MISRA C++:2008 规则的自定义选择，请使用 XML 文件。
使用 misra_cpp_2008_rules.xml 文件作为模板来创建 XML 文件，在其中定义编码标准检查项的自定义选择。此模板文件位于 polyspaceroot\polyspace\examples\doc_cxx\coding_standards_XMLpolyspacerootC:\Program Files\Polyspace\R2025a。要更新您的脚本，请参阅下表：
| 选项 | 改用 |
|---|---|
-misra-cpp "custom_standard.conf" | -checkers-selection-file misra_cpp_2008_rules.xml -misra-cpp from-file |
注意
在以后的版本中，检查项配置文件的 XML 格式可能会有所变化。
1 MISRA is a registered trademark of MIRA Ltd., held on behalf of the MISRA Consortium.
