C and C++


LANG.PREPROC.IF : Use of #if

Summary

A use of the #if preprocessor directive.

Many coding standards forbid the use of #if because it makes code harder for human readers to understand.

Properties

Class Name Use of #if
Significance style
Mnemonic LANG.PREPROC.IF
Categories
AUTOSARC++14 AUTOSARC++14:A16-0-1 The pre-processor shall only be used for unconditional and conditional file inclusion and include guards, and using the following directives: (1) #ifndef, (2) #ifdef, (3) #if, (4) #if defined, (5) #elif, (6) #else, (7) #define, (8) #endif, (9) #include.
CWE CWE:1076 Insufficient Adherence to Expected Conventions
JSF++ JSF++:26 Only the following pre-processor directives shall be used: #ifndef, #define, #endif, #include.
POW10 POW10:8 Limit the use of the preprocessor to file inclusion and simple macros.
Availability Available for C and C++.
Enabling Checks for this warning class are disabled by default. To enable them, add the following WARNING_FILTER rule to the project configuration file.
WARNING_FILTER += allow class="Use of #if"

Example

#if 0      /* 'Use of #if' warning issued here */
int unused;
#endif              /* ('Use of #endif' warning issued here if enabled) */

Relevant Configuration File Parameters

The following configuration file parameters affect checks for this warning class.