C and C++


MATH.DOMAIN.FE_INVALID : Raises FE_INVALID

Summary

An attempt to call a floating point function on a value that is outside its domain and will result in FE_INVALID being raised.

Properties

Class Name Raises FE_INVALID
Significance style
Mnemonic MATH.DOMAIN.FE_INVALID
Categories
MisraC2023 MisraC2023:D.4.11 The validity of values passed to library functions shall be checked
Misra2012 Misra2012:D.4.11 The validity of values passed to library functions shall be checked
Misra2004 Misra2004:20.3 The validity of values passed to library functions shall be checked
AUTOSARC++14 AUTOSARC++14:A0-4-4 Range, domain and pole errors shall be checked when using math functions.
CWE CWE:628 Function Call with Incorrectly Specified Arguments
  CWE:687 Function Call With Incorrectly Specified Argument Value
  CWE:688 Function Call With Incorrect Variable or Reference as Argument
CERT-C CERT-C:FLP32-C Prevent or detect domain and range errors in math functions
Availability Available for C and C++.
Enabling Checks for this warning class are enabled by default. To disable them, add the following WARNING_FILTER rule to the project configuration file.
WARNING_FILTER += discard class="Raises FE_INVALID"

Triggers

CodeSonar ships with library models that allow it to recognize functions such as libm remainder() that may raise FE_INVALID. If one of these functions is called with a finite value in the numerator parameter position and zero in the denominator parameter position, a warning will be issued.

If you have created a custom library model for some function f() in terms of one of these existing models, calls to f() will also be capable of triggering Raises FE_INVALID warnings.

Example

#include <math.h>

double use_fmod(double ind){
    double a = fmod(1,1);                 /* ok */
    double b = fmod(1,0);     /* 'Raises FE_INVALID' warning issued here */
    double c = fmod(ind,0);   /* 'Raises FE_INVALID' warning issued here */
    double d = fmod(ind,ind); /* EVIDENCED ONLY: 'Raises FE_INVALID' warning issued here
                               * if CodeSonar has evidence that use_fmod() is called on a value equal to 0.  */
    return a+b+c+d;
}

Relevant Configuration File Parameters

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