std::islessequal

Определено в заголовке `<cmath>`
	(1)
bool islessequal( float x, float y ); bool islessequal( double x, double y ); bool islessequal( long double x, long double y );		(с C++11) (до C++23)
constexpr bool islessequal( /* floating-point-type / x, / floating-point-type */ y );		(с 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 в противном случае.

Примечания

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

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

Если num1 или num2 имеет тип long double, то 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/w/cpp/numeric/math/islessequal