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.

CodeSonar® 9.2p0 CONFIDENTIAL CodeSecure Inc
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
MisraC2025 MisraC2025:D.4.1 Run-time failures shall be minimized
  MisraC2025:D.4.11 The validity of values passed to library functions shall be checked
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.
MisraC++2023 MisraC++2023:0.3.2 A function call shall not violate the function's preconditions
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
OWASP-2021 OWASP-2021:A4 Insecure design
OWASP-2025 OWASP-2025:A06 Insecure Design
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.

 

To report problems with this documentation, please visit https://support.codesecure.com/.