C and C++


MATH.DOMAIN.POW : Undefined Power of Zero

Summary

A power function is called with zero in the "base" argument position and zero or a negative value in the "exponent" argument position.

Properties

Class Name Undefined Power of Zero
Significance reliability
Mnemonic MATH.DOMAIN.POW
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="Undefined Power of Zero"

Triggers

CodeSonar ships with library models that allow it to recognize functions such as libm pow() that compute a power. If one of these functions is called with zero in the "base" parameter position and zero or a negative value in the "power" 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 Undefined Power of Zero warnings.

Example

#include <math.h>

double call_pow(double base, double exp){
    double a = pow(1,1);                           /* ok: base and exponent both > 0 */
    double b = pow(0,5);                           /* ok: exponent > 0 */
    double c = pow(0,-1);      /* 'Undefined Power of Zero' warning issued here */
    double d = pow(base,-1);            /* EVIDENCED ONLY: 'Undefined Power of Zero' warning issued here
                                         * if CodeSonar has evidence that call_pow() is called with a value ==0 as the first argument. */
    double e = pow(0,exp);     /* 'Undefined Power of Zero' warning issued here */
    double f = pow(base,exp);           /* EVIDENCED ONLY: 'Undefined Power of Zero' warning issued here
                                         * if CodeSonar has evidence that call_pow() is called with a value ==0 as the first argument. */

    return a+b+c+d+e+f;
}

Relevant Configuration File Parameters

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