std::ilogb

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов(C++20)

Библиотека метапрограммирования(C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов(C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения(C++11)

Атомарные операции(C++11)

Библиотека поддержки конкуренции(C++11)

Библиотека файловой системы(C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Библиотека числовых данных

Общие математические функции

Специальные математические функции(C++17)

Математические константы(C++20)

Среда с плавающей точкой(C++11)

Комплексные числа

Числовые массивы

Генерация псевдослучайных чисел

Рациональная арифметика времени компиляции(C++11)

Факторные операции

gcd (C++17)

lcm (C++17)

Интерполяции

midpoint (C++20)

lerp (C++20)

Общие числовые операции

iota (C++11)

ranges::iota (C++23)

accumulate

inner_product

adjacent_difference

partial_sum

reduce (C++17)

transform_reduce (C++17)

inclusive_scan (C++17)

exclusive_scan (C++17)

transform_inclusive_scan (C++17)

transform_exclusive_scan (C++17)

Операции с битами

bit_cast (C++20)

byteswap (C++23)

has_single_bit (C++20)

bit_ceil (C++20)

bit_floor (C++20)

bit_width (C++20)

rotl (C++20)

rotr (C++20)

countl_zero (C++20)

countl_one (C++20)

countr_zero (C++20)

countr_one (C++20)

popcount (C++20)

endian (C++20)

 

Общие математические функции

Функции
Основные операции
abs(int)labsllabsimaxabs (C++11) abs(float)fabs divldivlldivimaxdiv (C++11) fmod	remainder (C++11) remquo (C++11) fma (C++11) fmax (C++11) fmin (C++11) fdim (C++11) nannanfnanl (C++11)(C++11)(C++11)
Экспоненциальные функции
exp exp2 (C++11) expm1 (C++11)	log log10 log1p (C++11) log2 (C++11)
Степенные функции
sqrt cbrt (C++11)	hypot (C++11) pow
Тригонометрические и гиперболические функции
sin cos tan asin acos atan atan2	sinh cosh tanh asinh (C++11) acosh (C++11) atanh (C++11)

Ошибка и гамма функции
erf (C++11) erfc (C++11)	lgamma (C++11) tgamma (C++11)
Операции целочисленного округления с плавающей запятой
ceil floor roundlroundllround (C++11)(C++11)(C++11)	trunc (C++11) nearbyint (C++11) rintlrintllrint (C++11)(C++11)(C++11)
Функции манипуляции с плавающей запятой
ldexp scalbnscalbln (C++11)(C++11) ilogb (C++11) logb (C++11)	frexp modf nextafternexttoward (C++11)(C++11) copysign (C++11)
Классификация/Сравнение
fpclassify (C++11) isfinite (C++11) isinf (C++11) isnan (C++11) isnormal (C++11) signbit (C++11)	isgreater (C++11) isgreaterequal (C++11) isless (C++11) islessequal (C++11) islessgreater (C++11) isunordered (C++11)
Макро-константы
HUGE_VALFHUGE_VALHUGE_VALL (C++11)(C++11) INFINITY (C++11) NAN (C++11) math_errhandlingMATH_ERRNOMATH_ERREXCEPT (C++11)	FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C++11)(C++11)(C++11)(C++11)(C++11)

 

Определено в заголовочном файле <cmath>
int         ilogb(float arg );		(начиная с C++11)
int         ilogb(double arg );		(начиная с C++11)
int         ilogb(longdouble arg );		(начиная с C++11)
double      ilogb( Integral arg );		(начиная с C++11)
#define FP_ILOGB0 /*implementation-defined*/		(начиная с C++11)
#define FP_ILOGBNAN /*implementation-defined*/		(начиная с C++11)

Extracts the value of the exponent from the floating-point argument arg, and returns it as a signed integer value. Formally, the result is the integral part of log
r|arg| as a signed integral value, for non-zero arg, where r is std::numeric_limits<T>::radix and T is the floating-point type of arg.

Параметры

arg

—

плавающей точкой Оригинал: floating point value Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

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

The floating-point exponent, cast to integer, as if by static_cast<int>(std::logb(arg)).

Домена или диапазона ошибка может возникнуть, если arg равна нулю, FP_ILOGB0 возвращается в том случае.

Оригинал:

Domain or range error may occur if arg is zero, FP_ILOGB0 is returned in that case.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Домена или диапазона ошибка может возникнуть, если arg бесконечно, MAX_INT возвращается в том случае.

Оригинал:

Domain or range error may occur if arg is infinite, MAX_INT is returned in that case.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Домена или диапазона ошибка может возникнуть, если arg является NaN, FP_ILOGBNAN возвращается в том случае.

Оригинал:

Domain or range error may occur if arg is NaN, FP_ILOGBNAN is returned in that case.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Если результат не может быть представлен как int, результат не определен.

Оригинал:

If the result cannot be represented as int, the result is undefined.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Заметки

Значение показателя возвращается std::ilogb всегда равен 1 меньше показателя настраивали на std::frexp из-за различных требований нормализации: для показателя e возвращается std::ilogb, |arg*r-e
| находится между 1 и r (обычно между 1 и 2), но для экспоненты e возвращается std::frexp, |arg*2-e
| между 0.5 и 1.

Оригинал:

The value of the exponent returned by std::ilogb is always 1 less than the exponent retuned by std::frexp because of the different normalization requirements: for the exponent e returned by std::ilogb, |arg*r-e
| is between 1 and r (typically between 1 and 2), but for the exponent e returned by std::frexp, |arg*2-e
| is between 0.5 and 1.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Пример

Сравнивает различные функции с плавающей точкой разложения

Оригинал:

Compares different floating-point decomposition functions

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Запустить этот код

#include <iostream>#include <cmath>#include <limits>int main(){double f =123.45;std::cout<<"Given the number "<< f <<" or "<<std::hexfloat<< f <<std::defaultfloat<<" in hex,\n";   double f3;double f2 =std::modf(f, &f3);std::cout<<"modf() makes "<< f3 <<" + "<< f2 <<'\n';   int i; f2 =std::frexp(f, &i);std::cout<<"frexp() makes "<< f2 <<" * 2^"<< i <<'\n';   i = std::ilogb(f);std::cout<<"logb()/ilogb() make "<< f/std::scalbn(1.0, i)<<" * "<<std::numeric_limits<double>::radix<<"^"<< std::ilogb(f)<<'\n';}

Вывод:

Given the number 123.45 or 0x1.edccccccccccdp+6 in hex, modf() makes 123 + 0.45 frexp() makes 0.964453 * 2^7 logb()/ilogb() make 1.92891 * 2^6

См. также

frexpfrexpffrexpl (C++11)(C++11)	разлагает число на мантиссу и степень 2 (функция)
logblogbflogbl (C++11)(C++11)(C++11)	извлекает экспоненту числа (функция)
scalbnscalbnfscalbnlscalblnscalblnfscalblnl (C++11)(C++11)(C++11)(C++11)(C++11)(C++11)	умножает число на FLT_RADIX возведённое в степень (функция)