std:: exp, std:: expf, std:: expl
|
Определено в заголовочном файле
<cmath>
|
||
| (1) | ||
|
float
exp
(
float
num
)
;
double
exp
(
double
num
)
;
|
(до C++23) | |
|
/*floating-point-type*/
exp ( /*floating-point-type*/ num ) ; |
(начиная с C++23)
(constexpr начиная с C++26) |
|
|
float
expf
(
float
num
)
;
|
(2) |
(начиная с C++11)
(constexpr начиная с C++26) |
|
long
double
expl
(
long
double
num
)
;
|
(3) |
(начиная с C++11)
(constexpr начиная с C++26) |
|
SIMD перегрузка
(начиная с C++26)
|
||
|
Определено в заголовочном файле
<simd>
|
||
|
template
<
/*math-floating-point*/
V
>
constexpr
/*deduced-simd-t*/
<
V
>
|
(S) | (начиная с C++26) |
|
Дополнительные перегрузки
(начиная с C++11)
|
||
|
Определено в заголовочном файле
<cmath>
|
||
|
template
<
class
Integer
>
double exp ( Integer num ) ; |
(A) | (constexpr начиная с C++26) |
std::exp
для всех неквалифицированных cv типов с плавающей запятой в качестве типа параметра.
(начиная с C++23)
|
S)
Перегрузка SIMD выполняет поэлементное вычисление
std::exp
для
v_num
.
|
(since C++26) |
|
A)
Дополнительные перегрузки предоставляются для всех целочисленных типов, которые трактуются как
double
.
|
(since C++11) |
Содержание |
Параметры
| num | - | значение с плавающей точкой или целочисленное значение |
Возвращаемое значение
Если ошибок не возникает, возвращается экспонента по основанию
e
от
num
(
e
num
).
Если возникает ошибка диапазона из-за переполнения,
+HUGE_VAL
,
+HUGE_VALF
, или
+HUGE_VALL
возвращается.
Если происходит ошибка диапазона из-за потери значимости (underflow), возвращается корректный результат (после округления).
Обработка ошибок
Ошибки сообщаются, как указано в math_errhandling .
Если реализация поддерживает арифметику с плавающей запятой IEEE (IEC 60559),
- Если аргумент равен ±0, возвращается 1.
- Если аргумент равен -∞, возвращается +0.
- Если аргумент равен +∞, возвращается +∞.
- Если аргумент равен NaN, возвращается NaN.
Примечания
Для IEEE-совместимого типа double переполнение гарантировано, если 709.8 < num , а исчезновение порядка гарантировано, если num < -708.4 .
Дополнительные перегрузки не обязаны быть предоставлены в точности как (A) . Они лишь должны быть достаточными для обеспечения того, чтобы для их аргумента num целочисленного типа, std :: exp ( num ) имел тот же эффект, что и std :: exp ( static_cast < double > ( num ) ) .
Пример
#include <cerrno> #include <cfenv> #include <cmath> #include <cstring> #include <iomanip> #include <iostream> #include <numbers> // #pragma STDC FENV_ACCESS ON consteval double approx_e() { long double e{1.0}; for (auto fac{1ull}, n{1llu}; n != 18; ++n, fac *= n) e += 1.0 / fac; return e; } int main() { std::cout << std::setprecision(16) << "exp(1) = e¹ = " << std::exp(1) << '\n' << "numbers::e = " << std::numbers::e << '\n' << "approx_e = " << approx_e() << '\n' << "FV of $100, continuously compounded at 3% for 1 year = " << std::setprecision(6) << 100 * std::exp(0.03) << '\n'; // special values std::cout << "exp(-0) = " << std::exp(-0.0) << '\n' << "exp(-Inf) = " << std::exp(-INFINITY) << '\n'; // error handling errno = 0; std::feclearexcept(FE_ALL_EXCEPT); std::cout << "exp(710) = " << std::exp(710) << '\n'; if (errno == ERANGE) std::cout << " errno == ERANGE: " << std::strerror(errno) << '\n'; if (std::fetestexcept(FE_OVERFLOW)) std::cout << " FE_OVERFLOW raised\n"; }
Возможный вывод:
exp(1) = e¹ = 2.718281828459045
numbers::e = 2.718281828459045
approx_e = 2.718281828459045
FV of $100, continuously compounded at 3% for 1 year = 103.045
exp(-0) = 1
exp(-Inf) = 0
exp(710) = inf
errno == ERANGE: Numerical result out of range
FE_OVERFLOW raised
Смотрите также
|
(C++11)
(C++11)
(C++11)
|
возвращает
2
в заданной степени (
2
x
)
(функция) |
|
(C++11)
(C++11)
(C++11)
|
возвращает
e
в заданной степени, минус
1
(
e
x
-1
)
(функция) |
|
(C++11)
(C++11)
|
вычисляет натуральный логарифм (по основанию
e
) (
ln(x)
)
(функция) |
|
комплексная экспонента по основанию
e
(шаблон функции) |
|
|
применяет функцию
std::exp
к каждому элементу valarray
(шаблон функции) |
|
|
Документация C
для
exp
|
|