feholdexcept

Определено в заголовке `<fenv.h>`
int feholdexcept( fenv_t* envp );		(с C99)

Сначала сохраняет текущую среду с плавающей запятой в объект, на который указывает envp (аналогично fegetenv), затем очищает все флаги состояния с плавающей запятой и устанавливает режим непрерывной работы: будущие исключения с плавающей запятой не будут прерывать выполнение (не будут ловить исключения), пока среда с плавающей запятой не будет восстановлена с помощью feupdateenv или fesetenv.

Эта функция может использоваться в начале подпрограммы, которая должна скрыть исключения с плавающей запятой, которые она может генерировать от вызывающей стороны. Если необходимо подавить только некоторые исключения, а другие необходимо сообщить, режим непрерывной работы обычно завершается вызовом feupdateenv после очистки нежелательных исключений.

Параметры

envp - указатель на объект типа fenv_t, где будет храниться среда с плавающей запятой

Значение возврата

0 при успешном выполнении, в противном случае — ненулевое значение.

Пример

#include <stdio.h>
#include <fenv.h>
#include <float.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");
}
 
double x2 (double x)   /* times two */
{
    fenv_t curr_excepts;
 
    /* Save and clear current f-p environment. */
    feholdexcept(&curr_excepts);
 
    /* Raise inexact and overflow exceptions. */
    printf("In x2():  x = %f\n", x=x*2.0);
    show_fe_exceptions();
    feclearexcept(FE_INEXACT);   /* hide inexact exception from caller */
 
    /* Merge caller's exceptions (FE_INVALID)        */
    /* with remaining x2's exceptions (FE_OVERFLOW). */
    feupdateenv(&curr_excepts);
    return x;
}
 
int main(void)
{    
    feclearexcept(FE_ALL_EXCEPT);
    feraiseexcept(FE_INVALID);   /* some computation with invalid argument */
    show_fe_exceptions();
    printf("x2(DBL_MAX) = %f\n", x2(DBL_MAX));
    show_fe_exceptions();
 
    return 0;
}

Вывод:

current exceptions raised:  FE_INVALID
In x2():  x = inf
current exceptions raised:  FE_INEXACT FE_OVERFLOW
x2(DBL_MAX) = inf
current exceptions raised:  FE_INVALID FE_OVERFLOW

Ссылки

Стандарт C11 (ISO/IEC 9899:2011):

7.6.4.2 Функция feholdexcept (с. 213-214)

Стандарт C99 (ISO/IEC 9899:1999):

7.6.4.2 Функция feholdexcept (с. 194-195)

См. также

feupdateenv (C99)	восстанавливает среду с плавающей запятой и генерирует ранее возникшие исключения (функция)
fegetenvfesetenv (C99)	сохраняет или восстанавливает текущую среду с плавающей запятой (функция)
FE_DFL_ENV (C99)	стандартная среда с плавающей запятой (макроконстанта)
Документация C++ для `feholdexcept`

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/c/numeric/fenv/feholdexcept