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

パラメータ

戻り値

エラーが発生しなかった場合、 e num
-1 が返されます。

オーバーフローによる範囲エラーが発生した場合、 +HUGE_VAL 、 +HUGE_VALF または +HUGE_VALL が返されます。

アンダーフローによる範囲エラーが発生した場合、正しい結果（丸め後）が返されます。

エラーハンドリング

エラーは、 math_errhandling で指定されている通りに報告されます。

IEEE浮動小数点演算（IEC 60559）を実装がサポートしている場合、

• 引数が±0の場合、変更されずに返されます。
• 引数が-∞の場合、-1が返されます。
• 引数が+∞の場合、+∞が返されます。
• 引数がNaNの場合、NaNが返されます。

注記

std::expm1 関数と std::log1p 関数は金融計算に有用です。例えば、小さな日次金利の計算時： (1+x) n
-1 は std :: expm1 ( n * std:: log1p ( x ) ) と表現できます。これらの関数は正確な逆双曲線関数の記述も簡素化します。

IEEE互換型 double の場合、 709.8 < num のときオーバーフローが保証されます。

追加のオーバーロードは (A) と完全に同一である必要はありません。それらは、整数型の引数 num に対して、 std :: expm1 ( num ) が std :: expm1 ( static_cast < double > ( num ) ) と同じ効果を持つことを保証するのに十分であればよいのです。

例

#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'
              << "1%の日次複利で30/360カレンダーにおける2日間の$100の利息収入\n"
              << "    = "
              << 100 * std::expm1(2 * std::log1p(0.01 / 360)) << '\n'
              << "exp(1e-16)-1 = " << std::exp(1e-16) - 1
              << ", しかし expm1(1e-16) = " << std::expm1(1e-16) << '\n';
    // 特殊値
    std::cout << "expm1(-0) = " << std::expm1(-0.0) << '\n'
              << "expm1(-Inf) = " << std::expm1(-INFINITY) << '\n';
    // エラー処理
    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
1%の日次複利で30/360カレンダーにおける2日間の$100の利息収入
    = 0.00555563
exp(1e-16)-1 = 0, しかし expm1(1e-16) = 1e-16
expm1(-0) = -0
expm1(-Inf) = -1
expm1(710) = inf
    errno == ERANGE: 結果が大きすぎます
    FE_OVERFLOW raised

関連項目