C and C++


MATH.RANGE : Floating Point Range Error

Summary

An attempt to call a floating point function on a value such that the result of the corresponding mathematical function would be unrepresentable, when no other MATH.RANGE.* warning class is appropriate.

Properties

Class Name Floating Point Range Error
Significance style
Mnemonic MATH.RANGE
Categories
MisraC2023 MisraC2023:D.4.1 Run-time failures shall be minimized
  MisraC2023:D.4.11 The validity of values passed to library functions shall be checked
Misra2012 Misra2012:D.4.1 Run-time failures shall be minimized
  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="Floating Point Range Error"

Triggers

CodeSonar ships with library models that allow it to recognize functions such as libm atanh() that compute a mathematical function whose result is unrepresentable for some inputs. If one of these functions is called with an unsuitable value in the input 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 Floating Point Range Error warnings.

Example

#include <math.h>

double call_atanh(double ind){
    double a = atanh(0.1);                /* ok */
    double b = atanh(1);   /* 'Floating Point Range Error' warning issued here */
    double c = atanh(10);  /* domain, rather than range, error: 'Argument Too High' (MATH.DOMAIN.TOOHIGH)
                            * warning issued here */
    double d = atanh(ind); /* EVIDENCED ONLY: 'Floating Point Range Error' warning issued here
                            * if CodeSonar has evidence that call_atanh() is called on a value equal to 1 or -1. */
    return a+b+c+d;
}

Relevant Configuration File Parameters

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