LANG.PREPROC.WARNING : Use of #warning

JavaScript is not currently enabled, but is required for full CodeSonar manual search and browse functionality.

If you are viewing this file in your hub's Web GUI, enable JavaScript in your browser: you will also need it for GUI functionality.

If you opened this file directly from disk, your browser may be directly suppressing JavaScript functionality: certain browsers perform this suppression on local files (but not files delivered by web servers) for security reasons.

If you access the manual through the hub's Web GUI, the functionality will not be suppressed because the hub is a web server.
Alternatively, your browser may allow you to explicitly disable the security setting that suppresses functionality. See the CodeSonar FAQ for more information.

CodeSonar^® 9.2p0

CONFIDENTIAL

CodeSecure Inc

C and C++

LANG.PREPROC.WARNING : Use of #warning

Summary

A use of the #warning preprocessor directive.

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

Properties

Class Name

Use of #warning

Significance

style

Mnemonic

LANG.PREPROC.WARNING

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 #warning"

Example

#warning "Unfinished work" /* 'Use of #warning' warning issued here
                            * ('Warning Directive' warning also issued) */

/* 'Use of #warning' warnings are issued even if the #warning directive is in a region excluded with #if 0 ... #endif.
 * 'Warning Directive' warnings are NOT issued in this case.
 */
#if 0
#warning "another warning" /* 'Use of #warning' warning issued here */
#endif

Relevant Configuration File Parameters

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

To report problems with this documentation, please visit https://support.codesecure.com/.