C and C++


MATH.DOMAIN.ATAN : Arctangent Domain Error

Summary

A two-argument arctangent function is passed 0 in the "y" argument position when it may also have been passed 0 in the "x" argument position.

Properties

Class Name Arctangent Domain Error
Significance reliability
Mnemonic MATH.DOMAIN.ATAN
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="Arctangent Domain Error"

Triggers

CodeSonar ships with library models that allow it to recognize functions such as libm atan2() that compute a two-argument arctangent. If one of these functions is called with zero in the "y" parameter position and may also have zero in the "x" 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 Arctangent Domain Error warnings.

Example

#include <math.h>

double use_atan2(double ind){
    double a = atan2(1,1);           /* ok: second (Y) argument is not zero */
    double b = atan2(1,0);           /* ok: first (X) argument is not zero */
    double c = atan2(0,0);  /* 'Arctangent Domain Error' warning issued here */
    return a+b+c;
}

Relevant Configuration File Parameters

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