Namespaces
Variants

feholdexcept

From cppreference.net
< c ‎ | numeric ‎ | fenv
Определено в заголовочном файле <fenv.h>
int feholdexcept ( fenv_t * envp ) ;
(начиная с C99)

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

Эта функция может использоваться в начале подпрограммы, которая должна скрывать исключения с плавающей точкой, которые она может вызвать, от вызывающей стороны. Если необходимо подавить только некоторые исключения, в то время как другие должны быть сообщены, режим non-stop обычно завершается вызовом 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)

Смотрите также

восстанавливает окружение чисел с плавающей точкой и вызывает ранее поднятые исключения
(функция)
сохраняет или восстанавливает текущее окружение чисел с плавающей точкой
(функция)
окружение чисел с плавающей точкой по умолчанию
(макроконстанта)
Документация C++ для feholdexcept