База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

<fenv.h> — среда с плаваща запетая

Заглавният файл <fenv.h> предоставя флагове за изключения и режими за управление на средата с плаваща запетая. С него програмите могат да проверяват изключителни състояния, да променят закръгляването и да запазват и възстановяват средата на нишка.

Версия: C23; repository compiler flag, production runtime not attested

Синтаксис

#include <fenv.h>
#pragma STDC FENV_ACCESS ON

<fenv.h> управлява флаговете за състояние и режимите за управление. fenv_t представя цялата динамична среда, fexcept_t — състоянието на изключенията, а femode_t — само режимите за управление. Динамичната среда е свързана с нишката.

FE_DIVBYZERO означава деление на нула, FE_INVALID — невалидна операция, FE_OVERFLOW — препълване, FE_UNDERFLOW — подпрепълване, а FE_INEXACT — неточен резултат. Обикновените аритметични операции не изчистват вече зададените флагове за изключения. Възстановяването на запазена среда с fesetenv обаче може да изчисти флаговете, които не са били зададени в запазеното състояние, без отделно извикване на feclearexcept. FE_ALL_EXCEPT комбинира с | всички поддържани изключения; ако няма такива, стойността е 0. Използвайте feclearexcept и fetestexcept.

FE_DOWNWARD закръгля към −∞, FE_UPWARD — към +∞, FE_TOWARDZERO — към нула, а FE_TONEAREST — до най-близката стойност. FE_TONEARESTFROMZERO закръгля до най-близката стойност, а ако две стойности са на равно разстояние, избира по-отдалечената от нулата. За FE_TONEAREST правилата за съответствие с IEC 60559 в приложение F гарантират закръгляване към четната стойност, когато двете стойности са на равно разстояние. Самото наличие на макроса не гарантира това правило. Макроси за отделните изключения и посоки съществуват само при съответна поддръжка; проверявайте с #ifdef. fegetround прочита динамичната посока, а fesetround я задава.

FE_DFL_ENV обозначава средата по подразбиране за fesetenv; FE_DFL_MODE обозначава режимите по подразбиране за fesetmode, без да възстановява флаговете. FE_DYNAMIC е токен за #pragma STDC FENV_ROUND FE_DYNAMIC, който избира динамично закръгляване; той не е аргумент за fesetround.

Използвайте #pragma STDC FENV_ACCESS ON, когато проверявате флагове или използвате нестандартни динамични режими. Проверявайте резултатите от операциите и възстановявайте запазеното състояние. Самият избор на C23 в компилатора на хранилище не доказва поддръжка в производствената среда за изпълнение.

Примери

#include <fenv.h>
#include <stdio.h>
#include <stdlib.h>

#pragma STDC FENV_ACCESS ON

int main(void)
{
    fenv_t saved;
    int cleared;

    if (fegetenv(&saved) != 0)
        return EXIT_FAILURE;

    if (feclearexcept(FE_ALL_EXCEPT) != 0) {
        (void)fesetenv(&saved);
        return EXIT_FAILURE;
    }

    cleared = fetestexcept(FE_ALL_EXCEPT) == 0;
    if (fesetenv(&saved) != 0)
        return EXIT_FAILURE;

    puts(cleared ? "flags clear" : "unexpected flags");
    return cleared ? EXIT_SUCCESS : EXIT_FAILURE;
}

Резултат

flags clear

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници