Redigera

Dela via


erf, erff, erfl, erfc, erfcf, erfcl

Computes the error function or the complementary error function of a value.

Syntax

double erf(
   double x
);
float erf(
   float x
); // C++ only
long double erf(
   long double x
); // C++ only
float erff(
   float x
);
long double erfl(
   long double x
);
double erfc(
   double x
);
float erfc(
   float x
); // C++ only
long double erfc(
   long double x
); // C++ only
float erfcf(
   float x
);
long double erfcl(
   long double x
);
#define erf(X) // Requires C11 or higher
#define erfc(X) // Requires C11 or higher

Parameters

x
A floating-point value.

Return value

The erf functions return the Gauss error function of x. The erfc functions return the complementary Gauss error function of x.

Remarks

The erf functions calculate the Gauss error function of x, which is defined as:

The error function of x equals two over the square root of pi times the integral from zero to x of e to the minus t squared d t.

The complementary Gauss error function is defined as 1 - erf(x). The erf functions return a value in the range -1.0 to 1.0. There's no error return. The erfc functions return a value in the range 0 to 2. If x is too large for erfc, the errno variable is set to ERANGE.

Because C++ allows overloading, you can call erf and erfc overloads that take and return float and long double types. In a C program, unless you're using the <tgmath.h> macro to call this function, erf and erfc always take and return a double.

If you use the <tgmath.h> erf() macro, the type of the argument determines which version of the function is selected. See Type-generic math for details.

By default, this function's global state is scoped to the application. To change this behavior, see Global state in the CRT.

Requirements

Function Required header
erf, erff, erfl, erfc, erfcf, erfcl <math.h>
erf macro <tgmath.h>

For more compatibility information, see Compatibility.

See also

Math and floating-point support