LANG.STRUCT.DECL.SNM : Modification of Standard Namespaces

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.STRUCT.DECL.SNM : Modification of Standard Namespaces

Summary

[C++ only] Code introduces a new declaration into the std namespace.

Properties

Class Name

Modification of Standard Namespaces

Significance

style

Mnemonic

LANG.STRUCT.DECL.SNM

Categories

AUTOSARC++14	AUTOSARC++14:A17-6-1	Non-standard entities shall not be added to standard namespaces.
MisraC++2023	MisraC++2023:5.10.1	User-defined identifiers shall have an appropriate form
CERT-CPP	CERT-CPP:DCL58-CPP	Do not modify the standard namespaces

Availability

Available for C++ only (not C).

Enabling

Checks for this warning class are disabled by default, and require the unnormalized C ASTs for the project. To enable them, add the following WARNING_FILTER rule and RETAIN_UNNORMALIZED_C_AST specification to the project configuration file.

RETAIN_UNNORMALIZED_C_AST = Yes
WARNING_FILTER += allow class="Modification of Standard Namespaces"

Note that retaining the unnormalized ASTs will increase the disk space used to store the project representation, and may make the analysis take longer.

Example

#include <vector>

// namespace 'std' is reserved in the C++ standard
namespace std {
  int myvar;                // 'Modification of Standard Namespaces' warning issued here

  namespace subspaceA {}    // 'Modification of Standard Namespaces' warning issued here
}

// namespace 'posix' is also reserved in the C++ standard
namespace posix {}                    // ok: this does not modify namespace 'posix'

namespace mynamespace {
  namespace std {
    int myothervar;                   // ok: belongs to namespace 'mynamespace::std' (not 'std')
    namespace subspaceB {}            // ok: belongs to namespace 'mynamespace::std' (not 'std')
  }
}

namespace std::subspaceC {} // 'Modification of Standard Namespaces' warning issued here

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/.