ISGREATER(3)

ИМЯ
isgreater, isgreaterequal, isless, islessequal, islessgreater, isunordered - сравнение чисел с плавающей запятой с учётом NaN

ОБЗОР
#include <math.h>

int isgreater(x, y);

int isgreaterequal(x, y);

int isless(x, y);

int islessequal(x, y);

int islessgreater(x, y);

int isunordered(x, y);

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

Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

Все функции, перечисленные здесь:
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L

ОПИСАНИЕ
Обычные операции сравнения (такие как < — «меньше чем») завершаются ошибкой, если одним из операндов является NaN. При этом возникает исключение. Для избежания подобной ситуации в C99 определены макросы, описанные ниже.

В данных макросах гарантируется однократное вычисление операндов. Аргументами могут быть любые типы с плавающей запятой (примечание: не передавайте в аргументах целочисленные значения, так как они не будут приведены к типу с плавающей запятой).

isgreater()
    Вычисляет (x) > (y) даже, если значение x или y равно NaN.

isgreaterequal()
    Вычисляет (x) >= (y) даже, если значение x или y равно NaN.

isless()
    Вычисляет (x) < (y) даже, если значение x или y равно NaN.

islessequal()
    Вычисляет (x) <= (y) даже, если значение x или y равно NaN.

islessgreater()
    Вычисляет (x) < (y) || (x) > (y) даже, если значение x или y равно NaN. Этот макрос не эквивалентен x != y, так как это выражение правдиво (true), если значение x или y равно NaN.

isunordered()
    Вычисляет, являются ли аргументы неупорядоченными (unordered), то есть не равен ли один из аргументов NaN.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
Все макросы, кроме isunordered(), возвращают результат сравнения; они возвращают 0, если один из аргументов равен NaN.

Макрос isunordered() возвращает 1, если значение x или y равно NaN, и 0 в противном случае.

ОШИБКИ
Ошибки не возникают.

АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение
isgreater(), isgreaterequal(), isless(), islessequal(), islessgreater(), isunordered() | Безвредность в нитях | MT-Safe

СООТВЕТСТВИЕ СТАНДАРТАМ
POSIX.1-2001, POSIX.1-2008, C99.

ЗАМЕЧАНИЯ
Не всё оборудование имеет эти возможности, и там, где их нет, они будут эмулироваться макросами. Это приведёт к небольшим потерям производительности. Не используйте эти макросы, если значения NaN для вас не существенны.

СМОТРИТЕ ТАКЖЕ
fpclassify(3), isnan(3)