std::exp2, std::exp2f, std::exp2l

Определено в заголовочном файле `<cmath>`
	(1)
float exp2 ( float num ); double exp2 ( double num ); long double exp2 ( long double num );		(до C++23)
/* floating-point-type / exp2 ( / floating-point-type */ num );		(с C++23) (constexpr с C++26)
float exp2f( float num );	(2)	(с C++11) (constexpr с C++26)
long double exp2l( long double num );	(3)	(с C++11) (constexpr с C++26)
Дополнительные перегрузки (с C++11)
Определено в заголовочном файле `<cmath>`
template< class Integer > double exp2 ( Integer num );	(A)	(constexpr с C++26)

1-3) Вычисляет 2 в степени заданного значения num. Библиотека предоставляет перегрузки std::exp2 для всех типов с плавающей точкой без квалификаторов cv в качестве типа параметра.(с C++23)

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

(с C++11)

Параметры

num

значение с плавающей точкой или целое число

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

Если ошибки не возникло, возвращается экспонента по основанию 2 от num (2^num).

Если возникает ошибка диапазона из-за переполнения, возвращается +HUGE_VAL, +HUGE_VALF, или +HUGE_VALL.

Если возникает ошибка диапазона из-за переполнения, возвращается правильный результат (после округления).

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

Ошибки сообщаются, как указано в math_errhandling.

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

Если аргумент равен ±0, возвращается 1.
Если аргумент равен -∞, возвращается +0.
Если аргумент равен +∞, возвращается +∞.
Если аргумент равен NaN, возвращается NaN.

Примечания

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

Пример

#include <cerrno>
#include <cfenv>
#include <cmath>
#include <cstring>
#include <iostream>
 
// #pragma STDC FENV_ACCESS ON
 
int main()
{
    std::cout << "exp2(4) = " << std::exp2(4) << '\n'
              << "exp2(0.5) = " << std::exp2(0.5) << '\n'
              << "exp2(-4) = " << std::exp2(-4) << '\n';
 
    // special values
    std::cout << "exp2(-0) = " << std::exp2(-0.0) << '\n'
              << "exp2(-Inf) = " << std::exp2(-INFINITY) << '\n';
 
    // error handling
    errno = 0;
    std::feclearexcept(FE_ALL_EXCEPT);
 
    std::cout << "exp2(1024) = " << std::exp2(1024) << '\n';
 
    if (errno == ERANGE)
        std::cout << "    errno == ERANGE: " << std::strerror(errno) << '\n';
    if (std::fetestexcept(FE_OVERFLOW))
        std::cout << "    FE_OVERFLOW raised\n";
}

Возможный вывод:

exp2(4) = 16
exp2(0.5) = 1.41421
exp2(-4) = 0.0625
exp2(-0) = 1
exp2(-Inf) = 0
exp2(1024) = inf
    errno == ERANGE: Numerical result out of range
    FE_OVERFLOW raised

См. также

expexpfexpl (C++11)(C++11)	возвращает e в заданной степени (\({\small e^x}\)e^x) (функция)
expm1expm1fexpm1l (C++11)(C++11)(C++11)	возвращает e в заданной степени минус единица (\({\small e^x-1}\)e^x-1) (функция)
log2log2flog2l (C++11)(C++11)(C++11)	двоичный логарифм данного числа (\({\small\log_{2}{x}}\)log₂(x)) (функция)
Документация на C для `exp2`

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