ИМЯ

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)):

Все функции, перечисленные здесь:

ОПИСАНИЕ

Обычные операции сравнения (такие как < — «меньше чем») завершаются ошибкой, если одним из операндов является 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).

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

POSIX.1-2001, POSIX.1-2008, C99.

ЗАМЕЧАНИЯ

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

СМОТРИТЕ ТАКЖЕ

fpclassify(3), isnan(3)