Namensräume
Varianten
Aktionen

fegetenv, fesetenv

Von cppreference.com
< c‎ | numeric‎ | fenv
Definiert in der Headerdatei <fenv.h>
int fegetenv( fenv_t* envp );
(1) (seit C99)
int fesetenv( const fenv_t* envp );
(2) (seit C99)

1) Versucht, den Status der Gleitkomma-Umgebung in dem von envp gezeigten Objekt zu speichern.

2) Versucht, die Gleitkomma-Umgebung aus dem von envp gezeigten Objekt herzustellen. Der Wert dieses Objekts muss zuvor durch einen Aufruf von feholdexcept oder fegetenv ermittelt worden sein oder eine Gleitkomma-Makrokonstante sein. Wenn in envp ein Gleitkomma-Status-Flag gesetzt ist, wird es in der Umgebung gesetzt (und ist dann mit fetestexcept testbar), aber die entsprechenden Gleitkomma-Ausnahmen werden nicht ausgelöst (die Ausführung wird ohne Unterbrechung fortgesetzt).

Inhalt

[bearbeiten] Parameter

envp - Zeiger auf das Objekt vom Typ fenv_t, das den Status der Gleitkomma-Umgebung enthält.

[bearbeiten] Rückgabewert

0 bei Erfolg, andernfalls ungleich Null.

[bearbeiten] Beispiel

#include <stdio.h>
#include <math.h>
#include <fenv.h>
 
#pragma STDC FENV_ACCESS ON
 
void show_fe_exceptions(void)
{
    printf("current exceptions raised: ");
    if(fetestexcept(FE_DIVBYZERO))     printf(" FE_DIVBYZERO");
    if(fetestexcept(FE_INEXACT))       printf(" FE_INEXACT");
    if(fetestexcept(FE_INVALID))       printf(" FE_INVALID");
    if(fetestexcept(FE_OVERFLOW))      printf(" FE_OVERFLOW");
    if(fetestexcept(FE_UNDERFLOW))     printf(" FE_UNDERFLOW");
    if(fetestexcept(FE_ALL_EXCEPT)==0) printf(" none");
    printf("\n");
}
 
void show_fe_rounding_method(void)
{
    printf("current rounding method:    ");
    switch (fegetround()) {
           case FE_TONEAREST:  printf ("FE_TONEAREST");  break;
           case FE_DOWNWARD:   printf ("FE_DOWNWARD");   break;
           case FE_UPWARD:     printf ("FE_UPWARD");     break;
           case FE_TOWARDZERO: printf ("FE_TOWARDZERO"); break;
           default:            printf ("unknown");
    };
    printf("\n");
}
 
void show_fe_environment(void)
{
    show_fe_exceptions();
    show_fe_rounding_method();
}    
 
int main(void)
{
    fenv_t curr_env;
    int rtn;
 
    /* Show default environment. */
    show_fe_environment();
    printf("\n");
 
    /* Perform some computation under default environment. */
    printf("+11.5 -> %+4.1f\n", rint(+11.5)); /* midway between two integers */
    printf("+12.5 -> %+4.1f\n", rint(+12.5)); /* midway between two integers */
    show_fe_environment();
    printf("\n");
 
    /* Save current environment. */
    rtn = fegetenv(&curr_env);
 
    /* Perform some computation with new rounding method. */
    feclearexcept(FE_ALL_EXCEPT);
    fesetround(FE_DOWNWARD);
    printf("1.0/0.0 = %f\n", 1.0/0.0);
    printf("+11.5 -> %+4.1f\n", rint(+11.5));
    printf("+12.5 -> %+4.1f\n", rint(+12.5));
    show_fe_environment();
    printf("\n");
 
    /* Restore previous environment. */
    rtn = fesetenv(&curr_env);
    show_fe_environment();
 
    return 0;
}

Ausgabe

current exceptions raised: none
current rounding method:   FE_TONEAREST
 
+11.5 -> +12.0
+12.5 -> +12.0
current exceptions raised: FE_INEXACT
current rounding method:   FE_TONEAREST
 
1.0/0.0 = inf
+11.5 -> +11.0
+12.5 -> +12.0
current exceptions raised: FE_DIVBYZERO FE_INEXACT
current rounding method:   FE_DOWNWARD
 
current exceptions raised: FE_INEXACT
current rounding method:   FE_TONEAREST

[bearbeiten] Referenzen

  • C11-Standard (ISO/IEC 9899:2011)
  • 7.6.4.1 Die Funktion fegetenv (S. 213)
  • 7.6.4.3 Die Funktion fesetenv (S. 214)
  • C99-Standard (ISO/IEC 9899:1999)
  • 7.6.4.1 Die Funktion fegetenv (S. 194)
  • 7.6.4.3 Die Funktion fesetenv (S. 195)

[bearbeiten] Siehe auch

speichert die Umgebung, löscht alle Statusflags und ignoriert alle zukünftigen Fehler
(function) [edit]
stellt die Floating-Point-Umgebung wieder her und löst die zuvor ausgelösten Ausnahmen aus
(function) [edit]
Standard-Gleitkomma-Umgebung
(macro constant) [edit]
C++ Dokumentation für fegetenv, fesetenv