LANG.PREPROC.RECURSIVE : Recursive Macro

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.

The name N of a macro appears in its expansion: either because the macro definition itself contains N, or because the definition contains the name of a different macro whose (eventual) expansion contains N.

Class Name

Recursive Macro

Significance

style

Mnemonic

LANG.PREPROC.RECURSIVE

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:710	Improper Adherence to Coding Standards
POW10	POW10:8	Limit the use of the preprocessor to file inclusion and simple macros.
JPL	JPL:20	Make only very limited use of the C pre-processor.

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="Recursive Macro"

/* 'Recursive Macro' warning issued on following line */
#define expl(a) \
    ((a)==1 ? 1 : ((a) * expl((a)-1)))
        
/* 'Recursive Macro' warning issued on following line */
#define x (y + 1)
#define y (x + 2)

Note that the warning report for example 2 will mark both macros as contributing to a recursion cycle; the special warning description box will be located next to the one that CodeSonar encountered first.

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

LANG.PREPROC.RECURSIVE : Recursive Macro

Summary

Properties

Examples

Relevant Configuration File Parameters