isgreater(3) isunordered

ОБЗОР

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

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

_XOPEN_SOURCE >= 600 || _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L;
или cc -std=c99

ОПИСАНИЕ

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