LANG.STRUCT.EXCP.ITHROW : Inappropriate throw in noexcept Function

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.EXCP.ITHROW : Inappropriate throw in noexcept Function

Summary

A noexcept function throws an exception.

Properties

Class Name

Inappropriate throw in noexcept Function

Significance

reliability

Mnemonic

LANG.STRUCT.EXCP.ITHROW

Categories

AUTOSARC++14	AUTOSARC++14:A15-4-2	If a function is declared to be noexcept, noexcept(true) or noexcept(<true condition>), then it shall not exit with an exception.
	AUTOSARC++14:A15-4-4	A declaration of non-throwing function shall contain noexcept specification.
	AUTOSARC++14:A18-5-9	Custom implementations of dynamic memory allocation and deallocation functions shall meet the semantic requirements specified in the corresponding "Required behaviour" clause from the C++ Standard.
MisraC++2023	MisraC++2023:18.5.1	A noexcept function should not attempt to propagate an exception to the calling function
CERT-CPP	CERT-CPP:MEM55-CPP	Honor replacement dynamic storage management requirements
JSF++	JSF++:208	C++ exceptions shall not be used (i.e. throw, catch and try shall not be used.)

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="Inappropriate throw in noexcept Function"

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 <new>
#include <stdexcept>

extern bool my_free(void *ptr);

void operator delete(void* ptr) noexcept { // 'Inappropriate throw in noexcept Function' warning issued here
    if (my_free(ptr))
        throw std::bad_alloc();                                     // operator delete() should never throw exceptions
}

int f(int i) noexcept {                    // 'Inappropriate throw in noexcept Function' warning issued here
    if (!i){
        throw std::invalid_argument("f() called on 0");
    }
    return i;
}

int g(int i) noexcept {                                       // declared noexcept, does not throw any exceptions
    return i;
}

int h(int i) {                                                // not declared noexcept, throws std::invalid_argument
    if (!i){
        throw std::invalid_argument("h() called on 0");
    }
    return i;
}

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