std::ilogb

<metanoindex/>

 

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)

 

<tbody> </tbody>

Определено в заголовочном файле <cmath>
int ilogb( float arg );		(начиная с C++11)
int ilogb( double arg );		(начиная с C++11)
int ilogb( long double 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 возведённое в степень (функция)