std::expm1, std::expm1f, std::expm1l

ヘッダー `<cmath>` で定義
	(1)
float expm1 ( float num ); double expm1 ( double num ); long double expm1 ( long double num );			(C++23まで)
/浮動小数点数型/ expm1 ( /浮動小数点数型/ num );			(C++23から) (C++26 以降 constexpr)
float expm1f( float num );		(2)	(C++11以降) (C++26 以降 constexpr)
long double expm1l( long double num );		(3)	(C++11以降) (C++26 以降 constexpr)
SIMDオーバーロード (C++26以降)
ヘッダー `<simd>` で定義
template< /math-floating-point/ V > constexpr /deduced-simd-t/<V> expm1 ( const V& v_num );		(S)	(C++26以降)
追加のオーバーロード (C++11以降)
ヘッダー `<cmath>` で定義
template< class Integer > double expm1 ( Integer num );		(A)	(C++26 以降 constexpr)

1-3) 与えられたべき乗 num における

e

（ネイピア数、2.7182818...）を計算し、そこから 1.0 を引きます。この関数は、num がゼロに近い場合、式 std::exp(num) - 1.0 よりも高精度です。ライブラリは、パラメータの型として、すべての cv-修飾されていない浮動小数点数型に対して std::expm1 のオーバーロードを提供します。(since C++23)

S) SIMD オーバーロードは、v_num に対して要素ごとの std::expm1 を実行します。

(定義については、math-floating-point および deduced-simd-t を参照してください。)

(C++26以降)

A) すべての整数型に対する追加のオーバーロードが提供されます。これらは double として扱われます。

(C++11以降)

#include <cerrno>
#include <cfenv>
#include <cmath>
#include <cstring>
#include <iostream>
// #pragma STDC FENV_ACCESS ON
 
int main()
{
    std::cout << "expm1(1) = " << std::expm1(1) << '\n'
              << "Interest earned in 2 days on $100, compounded daily at 1%\n"
              << "    on a 30/360 calendar = "
              << 100 * std::expm1(2 * std::log1p(0.01 / 360)) << '\n'
              << "exp(1e-16)-1 = " << std::exp(1e-16) - 1
              << ", but expm1(1e-16) = " << std::expm1(1e-16) << '\n';
 
    // special values
    std::cout << "expm1(-0) = " << std::expm1(-0.0) << '\n'
              << "expm1(-Inf) = " << std::expm1(-INFINITY) << '\n';
 
    // error handling
    errno = 0;
    std::feclearexcept(FE_ALL_EXCEPT);
 
    std::cout << "expm1(710) = " << std::expm1(710) << '\n';
 
    if (errno == ERANGE)
        std::cout << "    errno == ERANGE: " << std::strerror(errno) << '\n';
    if (std::fetestexcept(FE_OVERFLOW))
        std::cout << "    FE_OVERFLOW raised\n";
}

実行結果の例

expm1(1) = 1.71828
Interest earned in 2 days on $100, compounded daily at 1%
    on a 30/360 calendar = 0.00555563
exp(1e-16)-1 = 0, but expm1(1e-16) = 1e-16
expm1(-0) = -0
expm1(-Inf) = -1
expm1(710) = inf
    errno == ERANGE: Result too large
    FE_OVERFLOW raised

[編集] See also

expexpfexpl (C++11)(C++11)	与えられたべき乗に累乗した $e$ を返す (${\small e^x}$ $e x$ ) (関数) [編集]
exp2exp2fexp2l (C++11)(C++11)(C++11)	与えられたべき乗に累乗した $2$ を返す (${\small 2^x}$ $2 x$ ) (関数) [編集]
log1plog1pflog1pl (C++11)(C++11)(C++11)	与えられた数値に $1$ を足した値の自然対数 ( $e$ を底とする) (${\small\ln{(1+x)}}$ $ln(1+x)$ ) (関数) [編集]
C ドキュメント for expm1

コンパイラサポート
フリースタンディングとホスト
言語
標準ライブラリ
標準ライブラリヘッダー
名前付き要件
機能テストマクロ (C++20)
言語サポートライブラリ
コンセプトライブラリ (C++20)
診断ライブラリ
メモリ管理ライブラリ
メタプログラミングライブラリ (C++11)
汎用ユーティリティライブラリ
コンテナライブラリ
イテレータライブラリ
Rangesライブラリ (C++20)
アルゴリズムライブラリ
文字列ライブラリ
テキスト処理ライブラリ
数値ライブラリ
日付と時刻ライブラリ
入出力ライブラリ
ファイルシステムライブラリ (C++17)
並行サポートライブラリ (C++11)
実行制御ライブラリ (C++26)
Technical specifications (技術仕様)
シンボルインデックス
外部ライブラリ

cppreference.com

名前空間

変種

表示

操作

std::expm1, std::expm1f, std::expm1l

目次

[編集] Parameters

[編集] Return value

[編集] Error handling

[編集] Notes

[編集] Example

[編集] See also

ナビゲーション

ツールボックス

expexpfexpl (C++11)(C++11)	与えられたべき乗に累乗した $e$ を返す (\({\small e^x}\) $e x$ ) (関数) [編集]
exp2exp2fexp2l (C++11)(C++11)(C++11)	与えられたべき乗に累乗した $2$ を返す (\({\small 2^x}\) $2 x$ ) (関数) [編集]
log1plog1pflog1pl (C++11)(C++11)(C++11)	与えられた数値に $1$ を足した値の自然対数 ( $e$ を底とする) (\({\small\ln{(1+x)}}\) $ln(1+x)$ ) (関数) [編集]
C ドキュメント for expm1