---

   feclearexcept - fesetexceptflag,

---

---

ОБЗОР

#include <fenv.h>

Компонуется при указании параметра -lm.

---

ОПИСАНИЕ

Исключения

Исключение переполнение (overflow) возникает, когда результат возможно представить в виде числа с плавающей запятой, но он намного больше абсолютного значения самого большого (конечного) представимого числа с плавающей запятой.

Исключение потеря-значащего-разряда (underflow) возникает, когда результат можно представить в виде числа с плавающей запятой, но он меньше абсолютного значения самого малого положительного нормализованного числа с плавающей запятой (и возникает большая потеря точности, если представить его в виде денормализованного числа).

Исключение inexact возникает, когда округлённый результат операции не равен бесконечной точности результата. Оно может произойти при исключении overflow или underflow.

Исключение invalid возникает, когда при операции получается плохо определённый результат (no well-defined result), например, при 0/0 или бесконечность - бесконечность или sqrt(-1).

Обработка исключений

Если реализацией поддерживается обработка определённого исключения, то определён соответствующий макрос: FE_DIVBYZERO, FE_INEXACT, FE_INVALID, FE_OVERFLOW, FE_UNDERFLOW. Если таким способом определить соответствующий бит(ы), например, с целочисленным аргументом FE_OVERFLOW|FE_UNDERFLOW, то могут вызываться функции обработки исключений. Могут поддерживаться и другие исключения. Макрос FE_ALL_EXCEPT — это побитовый OR всех бит, соответствующих поддерживаемым исключениям.

Функция feclearexcept() очищает поддерживаемые исключения, указанные битами в аргументе.

Функция fegetexceptflag() сохраняет представление состояния флагов исключения, представленного аргументом excepts в скрытом (opaque) объекте *flagp.

Функция feraiseexcept() возбуждает поддерживаемые исключения, заданные битами в excepts.

Функция fesetexceptflag() задаёт полное состояние для исключений, представленных в excepts, в значение *flagp. Это значение должно быть получено с помощью вызова fegetexceptflag() с последним аргументом, значение которого содержит все биты в excepts.

Функция fetestexcept() возвращает слово, в котором биты устанавливаются в соответствии с установленными битами в аргументе excepts и для которых установлено соответствующее исключение.

Режим округления

Если в реализации поддерживается получение и установка направления округления, то для них определены соответствующие макросы: FE_TONEAREST, FE_UPWARD, FE_DOWNWARD и FE_TOWARDZERO.

Функция fegetround() возвращает макрос, соответствующий текущему режиму округления.

Функция fesetround() задаёт режим округления в соответствии со значением аргумента и возвращает ноль при успешном выполнении.

В C99 и POSIX.1-2008 в файле <float.h> описан идентификатор FLT_ROUNDS, который определяет используемый реализацией режим поведения для сложения чисел с плавающей запятой. Значениями идентификатора могут быть:

Существуют другие значения для нестандартных режимов округления, зависящие от архитектуры.

Значение FLT_ROUNDS должно отражать текущий режим округления, который задаётся с помощью fesetround() (но смотрите ДЕФЕКТЫ).

Окружение плавающей запятой

Функция fegetenv() сохраняет текущее окружение плавающей запятой в объект *envp.

Функция feholdexcept() делает то же самое, затем очищает все флаги исключений и включает безостановочный режим (продолжать при возникновении исключений), если он доступен. При успешном выполнении возвращается ноль.

Функция fesetenv() восстанавливает окружение плавающей запятой из объекта *envp. Данный объект должен быть корректен, например, должен быть получен из вызова fegetenv() или feholdexcept() или равен FE_DFL_ENV. Данный вызов не возбуждает исключения.

Функция feupdateenv() устанавливает окружение плавающей запятой, представленное объектом *envp, за исключением того, что уже возбуждённые исключения не очищаются. После вызова этой функции, возбуждённые исключения будут побитово сложены с установленными ранее в *envp. Как и для предыдущей функции, объект *envp должен быть корректен.

---

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

ВЕРСИИ

---

АТРИБУТЫ

Интерфейс Атрибут Значение
feclearexcept(), fegetexceptflag(), feraiseexcept(), fesetexceptflag(), fetestexcept(), fegetround(), fesetround(), fegetenv(), feholdexcept(), fesetenv(), feupdateenv(), feenableexcept(), fedisableexcept(), fegetexcept() безвредность в потоках: MT-Safe

---

СООТВЕТСТВИЕ СТАНДАРТАМ

---

ЗАМЕЧАНИЯ

Замечания по glibc

#define _GNU_SOURCE         /* см. feature_test_macros(7) */


#include <fenv.h>
int feenableexcept(int excepts);


int fedisableexcept(int excepts);


int fegetexcept(void);

Функции feenableexcept() и fedisableexcept() включают (отключают) ловушки для каждого исключения, представленного в excepts, и при успешном выполнении возвращают старый набор включённых исключений, и -1 в противном случае. Функция fegetexcept() возвращает набор всех включённых в данных момент исключений.

ДЕФЕКТЫ