std::signbit

Определено в заголовке `<cmath>`
bool signbit( float num ); bool signbit( double num ); bool signbit( long double num );	(1)	(начиная с C++11) (до C++23)
constexpr bool signbit( /floating-point-type/ num );	(1)		(начиная с C++23)
Перегрузка SIMD (начиная с C++26)
Определено в заголовке `<simd>`
template< /math-floating-point/ V > constexpr typename /deduced-simd-t/<V>::mask_type signbit ( const V& v_num );	(S)	(начиная с C++26)
Дополнительные перегрузки
Определено в заголовке `<cmath>`
template< class Integer > bool signbit( Integer num );	(A)	(начиная с C++11) (constexpr начиная с C++23)

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

S) Перегрузка SIMD выполняет поэлементную операцию std::signbit над v_num. (Определения приведены в разделах math-floating-point и deduced-simd-t.) (начиная с C++26)

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

Параметры

num	-	значение с плавающей точкой или целочисленное значение
v_num	-	объект с параллельными данными специализации `std::basic_simd`, тип элемента которого является типом с плавающей точкой

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

1) true, если num отрицательно, и false в противном случае.

S) Объект маски с параллельными данными, i-й элемент которого равен true, если v_num[i] отрицательно, и false в противном случае для всех i в диапазоне [0, v_num.size()).

Примечания

Эта функция определяет знаковый бит нулей, бесконечностей и NaN. Наряду с std::copysign, std::signbit является одним из двух единственных переносимых способов проверить знак NaN.

Дополнительные перегрузки не обязаны предоставляться точно в виде (A). Они должны лишь обеспечивать, чтобы для аргумента num целочисленного типа std::signbit(num) имело тот же эффект, что и std::signbit(static_cast<double>(num)).

Пример

#include <cmath>
#include <iostream>

int main()
{
    std::cout << std::boolalpha
              << "signbit(+0.0) = " << std::signbit(+0.0) << '\n'
              << "signbit(-0.0) = " << std::signbit(-0.0) << '\n'
              << "signbit(+nan) = " << std::signbit(+NAN) << '\n'
              << "signbit(-nan) = " << std::signbit(-NAN) << '\n'
              << "signbit(+inf) = " << std::signbit(+INFINITY) << '\n'
              << "signbit(-inf) = " << std::signbit(-INFINITY) << '\n';
}

Вывод:

signbit(+0.0) = false
signbit(-0.0) = true
signbit(+nan) = false
signbit(-nan) = true
signbit(+inf) = false
signbit(-inf) = true

См. также

abs(float)fabsfabsffabsl (C++11)(C++11)	абсолютное значение числа с плавающей точкой (\(\small{\|x\|}\)\|x\|) (функция)
copysigncopysignfcopysignl (C++11)(C++11)(C++11)	копирует знак числа с плавающей точкой (функция)
Документация по C для `signbit`

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