std::islessequal

Определён в заголовочном файле `<cmath>`
bool islessequal( float x, float y ); bool islessequal( double x, double y ); bool islessequal( long double x, long double y );	(1)	(начиная с C++11) (до C++23)
constexpr bool islessequal( /* floating-point-type / x, / floating-point-type */ y );	(1)		(начиная с C++23)
Дополнительные перегрузки
Определён в заголовочном файле `<cmath>`
template< class Arithmetic1, class Arithmetic2 > bool islessequal( Arithmetic1 x, Arithmetic2 y );	(A)	(начиная с C++11) (constexpr начиная с C++23)

1) Определяет, меньше ли или равно число с плавающей точкой x числу с плавающей точкой y, не устанавливая исключения с плавающей точкой. Библиотека предоставляет перегрузки для всех типов с плавающей точкой без квалификаторов cv в качестве типов параметров x и y.(начиная с C++23)

A) Предоставляются дополнительные перегрузки для всех остальных комбинаций арифметических типов.

Параметры

x, y

значения с плавающей точкой или целочисленные значения

Возвращаемое значение

true, если x <= y, иначе false.

Примечания

Встроенный operator<= для чисел с плавающей точкой может вызвать FE_INVALID, если один или оба аргумента являются NaN. Эта функция является «тихой» версией operator<=.

Не требуется, чтобы дополнительные перегрузки были предоставлены в точности в виде (A). Они должны лишь обеспечивать для первого аргумента num1 и второго аргумента num2 следующее:

Если num1 или num2 имеет тип longdouble, то std::islessequal(num1, num2) имеет тот же эффект, что и std::islessequal(static_cast<long double>(num1),static_cast<long double>(num2)).
В противном случае, если num1 и/или num2 имеет тип double или целочисленный тип, то std::islessequal(num1, num2) имеет тот же эффект, что и std::islessequal(static_cast<double>(num1),static_cast<double>(num2)).
В противном случае, если num1 или num2 имеет тип float, то std::islessequal(num1, num2) имеет тот же эффект, что и std::islessequal(static_cast<float>(num1),static_cast<float>(num2)).

(до C++23)

Если num1 и num2 имеют арифметические типы, то std::islessequal(num1, num2) имеет тот же эффект, что и std::islessequal(static_cast</*common-floating-point-type*/>(num1),static_cast</*common-floating-point-type*/>(num2)), где /*common-floating-point-type*/ — тип с плавающей точкой с наибольшим рангом преобразования типа с плавающей точкой и наибольшим подрангом преобразования типа с плавающей точкой среди типов num1 и num2; аргументы целочисленного типа считаются имеющими тот же ранг преобразования типа с плавающей точкой, что и double.

Если тип с наибольшими рангом и подрангом не существует, то разрешение перегрузки не приводит к появлению подходящего кандидата среди предоставленных перегрузок.

(начиная с C++23)

См. также

less_equal	функциональный объект, реализующий `x <= y` (шаблон класса)
isgreaterequal (C++11)	проверяет, больше ли или равно первый аргумент с плавающей точкой второму (функция)
Документация по C для `islessequal`

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/numeric/math/islessequal