std:: acosh, std:: acoshf, std:: acoshl

、$タグ内のテキストは翻訳していません\; -\; C++固有の用語（Parameters、Return\; value、Error\; handling、Notes、Examples、See\; also、External\; links）は原文のまま保持しています\; -\; 書式と構造は完全に保持されています$

パラメータ

戻り値

エラーが発生しない場合、 num の逆双曲線余弦（ cosh -1
(num) または arcosh(num) ）が区間 [0, +∞] で返されます。

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

エラーハンドリング

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

引数が1未満の場合、定義域エラーが発生します。

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

• 引数が1未満の場合、 FE_INVALID が発生し、NaNが返されます。
• 引数が1の場合、+0が返されます。
• 引数が+∞の場合、+∞が返されます。
• 引数がNaNの場合、NaNが返されます。

注記

C++がこの関数について参照するC標準ではこの関数を「逆双曲線余弦」と命名しているが、双曲線関数の逆関数は面積関数である。それらの引数は双曲線扇形の面積であり、弧ではない。正しい名称は「逆双曲線余弦」（POSIXで使用）または「面積双曲線余弦」である。

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

例

#include <cerrno>
#include <cfenv>
#include <cfloat>
#include <cmath>
#include <cstring>
#include <iostream>
// #pragma STDC FENV_ACCESS ON
int main()
{
    std::cout << "acosh(1) = " << std::acosh(1) << '\n'
              << "acosh(10) = " << std::acosh(10) << '\n'
              << "acosh(DBL_MAX) = " << std::acosh(DBL_MAX) << '\n'
              << "acosh(Inf) = " << std::acosh(INFINITY) << '\n';
    // エラー処理
    errno = 0;
    std::feclearexcept(FE_ALL_EXCEPT);
    std::cout << "acosh(0.5) = " << std::acosh(0.5) << '\n';
    if (errno == EDOM)
        std::cout << "    errno == EDOM: " << std::strerror(errno) << '\n';
    if (std::fetestexcept(FE_INVALID))
        std::cout << "    FE_INVALID raised\n";
}

acosh(1) = 0
acosh(10) = 2.99322
acosh(DBL_MAX) = 710.476
acosh(Inf) = inf
acosh(0.5) = -nan
    errno == EDOM: Numerical argument out of domain
    FE_INVALID raised

関連項目

外部リンク