std:: log1p, std:: log1pf, std:: log1pl

パラメータ

戻り値

エラーが発生しない場合、 ln(1+num) が返されます。

定義域エラーが発生した場合、実装定義の値が返されます（NaNがサポートされている場合はNaN）。

極エラーが発生した場合、 -HUGE_VAL , -HUGE_VALF 、または -HUGE_VALL が返されます。

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

エラーハンドリング

エラーは math_errhandling で指定された通りに報告されます。

ドメインエラーは、 num が -1 未満の場合に発生します。

num が -1 の場合、極エラーが発生する可能性があります。

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

• 引数が±0の場合、変更されずに返されます。
• 引数が-1の場合、-∞が返され、 FE_DIVBYZERO が発生します。
• 引数が-1未満の場合、NaNが返され、 FE_INVALID が発生します。
• 引数が+∞の場合、+∞が返されます。
• 引数がNaNの場合、NaNが返されます。

注記

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

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

例

#include <cerrno>
#include <cfenv>
#include <cmath>
#include <cstring>
#include <iostream>
// #pragma STDC FENV_ACCESS ON
int main()
{
    std::cout << "log1p(0) = " << log1p(0) << '\n'
              << "1%の日次複利で30/360カレンダーにおける2日間の$100の利息収入\n"
              << "    = "
              << 100 * expm1(2 * log1p(0.01 / 360)) << '\n'
              << "log(1+1e-16) = " << std::log(1 + 1e-16)
              << ", but log1p(1e-16) = " << std::log1p(1e-16) << '\n';
    // 特殊値
    std::cout << "log1p(-0) = " << std::log1p(-0.0) << '\n'
              << "log1p(+Inf) = " << std::log1p(INFINITY) << '\n';
    // エラー処理
    errno = 0;
    std::feclearexcept(FE_ALL_EXCEPT);
    std::cout << "log1p(-1) = " << std::log1p(-1) << '\n';
    if (errno == ERANGE)
        std::cout << "    errno == ERANGE: " << std::strerror(errno) << '\n';
    if (std::fetestexcept(FE_DIVBYZERO))
        std::cout << "    FE_DIVBYZERO raised\n";
}

log1p(0) = 0
1%の日次複利で30/360カレンダーにおける2日間の$100の利息収入
    = 0.00555563
log(1+1e-16) = 0, but log1p(1e-16) = 1e-16
log1p(-0) = -0
log1p(+Inf) = inf
log1p(-1) = -inf
    errno == ERANGE: 結果が大きすぎます
    FE_DIVBYZERO raised

関連項目