Namespaces
Variants

feclearexcept

From cppreference.net
< c ‎ | numeric ‎ | fenv
Definiert im Header <fenv.h>
int feclearexcept ( int excepts ) ;
(seit C99)

Versucht, die Gleitkomma-Ausnahmen zu löschen, die in der Bitmasken-Argument excepts aufgelistet sind, welches eine bitweise ODER-Verknüpfung der Gleitkomma-Ausnahmemakros ist.

Inhaltsverzeichnis

Parameter

excepts - Bitmaske, die die zu löschenden Ausnahmeflags auflistet

Rückgabewert

0 wenn alle angegebenen Ausnahmen erfolgreich gelöscht wurden oder wenn excepts null ist. Gibt einen Wert ungleich null bei einem Fehler zurück.

Beispiel

#include <fenv.h>
#include <stdio.h>
#include <math.h>
#include <float.h>
/*
 * Eine mögliche Implementierung von hypot, die viele erweiterte
 * Gleitkommafunktionen nutzt.
 */
double hypot_demo(double a, double b) {
  const int range_problem = FE_OVERFLOW | FE_UNDERFLOW;
  feclearexcept(range_problem);
  // Versuche einen schnellen Algorithmus
  double result = sqrt(a * a + b * b);
  if (!fetestexcept(range_problem))  // kein Überlauf oder Unterlauf
    return result;                   // gib das schnelle Ergebnis zurück
  // Führe eine komplexere Berechnung durch, um Überlauf/Unterlauf zu vermeiden
  int a_exponent,b_exponent;
  frexp(a, &a_exponent);
  frexp(b, &b_exponent);
  if (a_exponent - b_exponent > DBL_MAX_EXP)
    return fabs(a) + fabs(b);        // kleiner Wert kann ignoriert werden
  // Skaliere so, dass fabs(a) nahe 1 liegt
  double a_scaled = scalbn(a, -a_exponent);
  double b_scaled = scalbn(b, -a_exponent);
  // Überlauf und Unterlauf sind jetzt unmöglich
  result = sqrt(a_scaled * a_scaled + b_scaled * b_scaled);
  // Skalierung rückgängig machen
  return scalbn(result, a_exponent);
}
int main(void)
{
  // Normalfall nimmt den schnellen Weg
  printf("hypot(%f, %f) = %f\n", 3.0, 4.0, hypot_demo(3.0, 4.0));
  // Extremfall nimmt den langsamen aber präziseren Weg
  printf("hypot(%e, %e) = %e\n", DBL_MAX / 2.0, 
                                DBL_MAX / 2.0, 
                                hypot_demo(DBL_MAX / 2.0, DBL_MAX / 2.0));
  return 0;
}

Ausgabe:

hypot(3.000000, 4.000000) = 5.000000
hypot(8.988466e+307, 8.988466e+307) = 1.271161e+308

Referenzen

  • C11-Standard (ISO/IEC 9899:2011):
  • 7.6.2.1 Die feclearexcept-Funktion (S. 209)
  • C99-Standard (ISO/IEC 9899:1999):
  • 7.6.2.1 Die feclearexcept-Funktion (S. 190)

Siehe auch

bestimmt, welche der angegebenen Gleitkomma-Statusflags gesetzt sind
(Funktion)
C++-Dokumentation für feclearexcept