std::frexp, std::frexpf, std::frexpl

float       frexp ( float num, int* exp );
double      frexp ( double num, int* exp );
long double frexp ( long double num, int* exp );

constexpr /* floating-point-type */
            frexp ( /* floating-point-type */ num, int* exp );

float       frexpf( float num, int* exp );

long double frexpl( long double num, int* exp );

template< class Integer >
double      frexp ( Integer num, int* exp );

Параметры

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

Если num равно нулю, возвращает ноль и сохраняет ноль в *exp.

В противном случае (если num не равно нулю), если ошибок не произошло, возвращает значение x в диапазоне (-1, -0.5], [0.5, 1) и сохраняет целое значение в *exp такое, что x×2^(*exp)== num.

Если значение, которое должно быть сохранено в *exp, выходит за пределы диапазона int, поведение не определено.

Обработка ошибок

Данная функция не подвержена никаким ошибкам, указанным в math_errhandling.

Если реализация поддерживает IEEE арифметику с плавающей точкой (IEC 60559),

• Если num равно ±0, оно возвращается без изменений, а ​0​ сохраняется в *exp.
• Если num равно ±∞, оно возвращается, а неопределенное значение сохраняется в *exp.
• Если num равно NaN, возвращается NaN, а неопределенное значение сохраняется в *exp.
• Не генерируются исключения с плавающей точкой.
• Если FLT_RADIX равно 2 (или степени двойки), возвращаемое значение является точным, текущий режим округления игнорируется.

Примечания

В двоичной системе (где FLT_RADIX является 2), std::frexp может быть реализовано как

{
    *exp = (value == 0) ? 0 : (int)(1 + std::logb(value));
    return std::scalbn(value, -(*exp));
}

Функция std::frexp, вместе со своей двойственной функцией std::ldexp, может использоваться для управления представлением числа с плавающей точкой без непосредственных манипуляций с битами.

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

Пример

#include <cmath>
#include <iostream>
#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

См. также