Namensräume
Varianten
Aktionen

erfc, erfcf, erfcl

Von cppreference.com
< c‎ | numerik‎ | math
 
 
 
Allgemeine mathematische Funktionen
Funktionen
Grundlegende Operationen
(C99)
(C99)
(C99)
(C99)(C99)(C99)(C23)
Maximum/Minimum-Operationen
(C99)
(C99)
Exponentialfunktionen
(C23)
(C99)
(C99)
(C23)
(C23)

(C99)
(C99)(C23)
(C23)
(C23)
Potenzfunktionen
(C99)
(C23)
(C23)

(C99)
(C23)
(C23)
Trigonometrische und hyperbolische Funktionen
(C23)
(C23)
(C23)
(C23)
(C99)
(C99)
(C99)
Nächste ganze Gleitkommazahlen
(C99)(C99)(C99)
(C99)

(C99)(C99)(C99)
(C23)(C23)(C23)(C23)
Gleitkomma-Manipulation
(C99)(C99)
(C99)(C23)
(C99)
Verengende Operationen
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
Quanten- und Quantenexponent-Funktionen
Dezimal-Neu-Kodierungsfunktionen
Gesamtordnung und Payload-Funktionen
Klassifizierung
(C99)
(C99)
(C99)
(C23)
Fehler- und Gammafunktionen
(C99)
erfc
(C99)
(C99)
(C99)
Typen
Makrokonstanten
Spezielle Gleitkommawerte
(C99)(C23)
Argumente und Rückgabewerte
Fehlerbehandlung
Schnelle Operationsanzeigen
 
Definiert in Header <math.h>
float       erfcf( float arg );
(1) (seit C99)
double      erfc( double arg );
(2) (seit C99)
long double erfcl( long double arg );
(3) (seit C99)
Definiert in Header <tgmath.h>
#define erfc( arg )
(4) (seit C99)
1-3) Berechnet die komplementäre Fehlerfunktion von arg, d.h. 1.0 - erf(arg), jedoch ohne Präzisionsverlust für große arg.
4) Typ-generische Makro: Wenn arg den Typ long double hat, wird erfcl aufgerufen. Andernfalls, wenn arg einen ganzzahligen Typ oder den Typ double hat, wird erfc aufgerufen. Andernfalls wird erfcf aufgerufen.

Inhalt

[bearbeiten] Parameter

arg - Gleitkommawert

[bearbeiten] Rückgabewert

Wenn keine Fehler auftreten, wird der Wert der komplementären Fehlerfunktion von arg zurückgegeben, d.h.
2
π

arg
e-t2
dt
oder 1-erf(arg).

Wenn ein Bereichsfehler aufgrund eines Unterlaufs auftritt, wird das korrekte Ergebnis (nach Rundung) zurückgegeben.

[bearbeiten] Fehlerbehandlung

Fehler werden wie in math_errhandling angegeben gemeldet.

Wenn die Implementierung IEEE-Gleitkomma-Arithmetik (IEC 60559) unterstützt,

  • Wenn das Argument +∞ ist, wird +0 zurückgegeben.
  • Wenn das Argument -∞ ist, wird 2 zurückgegeben.
  • Wenn das Argument NaN ist, wird NaN zurückgegeben.

[bearbeiten] Anmerkungen

Für den IEEE-kompatiblen Typ double ist ein Unterlauf garantiert, wenn arg > 26.55.

[bearbeiten] Beispiel

#include <math.h>
#include <stdio.h>
 
double normalCDF(double x) // Phi(-∞, x) aka N(x)
{
    return erfc(-x / sqrt(2)) / 2;
}
 
int main(void)
{
    puts("normal cumulative distribution function:");
    for (double n = 0; n < 1; n += 0.1)
        printf("normalCDF(%.2f) %5.2f%%\n", n, 100 * normalCDF(n));
 
    printf("special values:\n"
           "erfc(-Inf) = %f\n"
           "erfc(Inf) = %f\n",
           erfc(-INFINITY),
           erfc(INFINITY));
}

Ausgabe

normal cumulative distribution function:
normalCDF(0.00) 50.00%
normalCDF(0.10) 53.98%
normalCDF(0.20) 57.93%
normalCDF(0.30) 61.79%
normalCDF(0.40) 65.54%
normalCDF(0.50) 69.15%
normalCDF(0.60) 72.57%
normalCDF(0.70) 75.80%
normalCDF(0.80) 78.81%
normalCDF(0.90) 81.59%
normalCDF(1.00) 84.13%
special values:
erfc(-Inf) = 2.000000
erfc(Inf) = 0.000000

[bearbeiten] Referenzen

  • C23-Standard (ISO/IEC 9899:2024)
  • 7.12.8.2 The erfc functions (S. 249-250)
  • 7.25 Typ-generische Mathematik <tgmath.h> (S. 373-375)
  • F.10.5.2 The erfc functions (S. 525)
  • C17-Standard (ISO/IEC 9899:2018)
  • 7.12.8.2 The erfc functions (S. 249-250)
  • 7.25 Typ-generische Mathematik <tgmath.h> (S. 373-375)
  • F.10.5.2 The erfc functions (S. 525)
  • C11-Standard (ISO/IEC 9899:2011)
  • 7.12.8.2 The erfc functions (S. 249-250)
  • 7.25 Typ-generische Mathematik <tgmath.h> (S. 373-375)
  • F.10.5.2 The erfc functions (S. 525)
  • C99-Standard (ISO/IEC 9899:1999)
  • 7.12.8.2 The erfc functions (S. 230)
  • 7.22 Typ-generische Mathematik <tgmath.h> (S. 335-337)
  • F.9.5.2 The erfc functions (S. 462)

[bearbeiten] Siehe auch

(C99)(C99)(C99)
berechnet die Fehlerfunktion
(Funktion) [bearbeiten]

[bearbeiten] Externe Links

Weisstein, Eric W. "Erfc." From MathWorld – A Wolfram Web Resource.