Main Content

MISRA C++:2023 Rule 5.7.1

The character sequence /* shall not be used within a C-style comment

Since R2024b

Description

Rule Definition

The character sequence /* shall not be used within a C-style comment.

Rationale

If your code contains a /* in a C-style comment (comment with /* */), it typically means that you have inadvertently commented out code. In particular, nesting of comments is not supported in C and might lead to unexpected errors.

Polyspace Implementation

The rule checker reports violations if the character /* appears within a C-style comment.

You cannot justify a violation of this rule using source code annotations.

Troubleshooting

If you expect a rule violation but Polyspace® does not report it, see Diagnose Why Coding Standard Violations Do Not Appear as Expected.

Examples

expand all

void setup(void);
void foo() {
    /* Initializer functions
     setup();
    /* Step functions */  //Noncompliant
}

In this example, the call to setup() is commented out because the ending */ is omitted, perhaps inadvertently. The checker flags this issue by highlighting the /* in the /* */ comment.

Check Information

Group: Lexical Conventions
Category: Required

Version History

Introduced in R2024b