名前空間
変種
操作

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

From cppreference.com
< cpp‎ | numeric‎ | math
 
 
 
 
ヘッダー <cmath> で定義
(1)
float          acosh ( float num );
double          acosh ( double num );
long double      acosh ( long double num );
(C++23まで)
/*浮動小数点数型*/
                   acosh ( /*浮動小数点型*/ num );
(C++23から)
(C++26 以降 constexpr)
float          acoshf( float num );
(2) (C++11以降)
(C++26 以降 constexpr)
long double      acoshl( long double num );
(3) (C++11以降)
(C++26 以降 constexpr)
ヘッダー <simd> で定義
template< /*math-floating-point*/ V >

constexpr /*deduced-simd-t*/<V>

                   acosh ( const V& v_num );
(S) (C++26以降)
ヘッダー <cmath> で定義
template< class Integer >
double          acosh ( Integer num );
(A) (C++26 以降 constexpr)
1-3) num の逆双曲線余弦を計算します。ライブラリは、パラメータの型として、すべての cv 修飾されていない浮動小数点型に対する std::acosh のオーバーロードを提供します。(C++23 以降)
S) SIMD オーバーロードは、v_num に対して要素ごとの std::acosh を実行します。
(定義については、math-floating-point および deduced-simd-t を参照してください。)
(C++26以降)
A) すべての整数型に対する追加のオーバーロードが提供されます。これらは double として扱われます。
(C++11以降)

目次

[編集] パラメータ

num - 浮動小数点数または整数値

[編集] 戻り値

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

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

[編集] エラー処理

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

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

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

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

[編集] 注記

C 標準(この関数に関して C++ が参照する)では、この関数を「arc hyperbolic cosine」と名付けていますが、双曲線関数の逆関数は面積関数です。その引数は、円弧ではなく、双曲線扇形の面積です。正しい名前は「inverse hyperbolic cosine」(POSIX で使用)または「area hyperbolic cosine」です。

追加のオーバーロードは、(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';
 
    // error handling
    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

[編集] 関連項目

(C++11)(C++11)(C++11)
逆双曲線正弦を計算する (arsinh(x))
(関数) [編集]
(C++11)(C++11)(C++11)
逆双曲線正接を計算する (artanh(x))
(関数) [編集]
(C++11)(C++11)
双曲線余弦を計算する (cosh(x))
(関数) [編集]
複素数の逆双曲線余弦 (エリアハイパボリックコサイン) を計算する (arcosh(z))
(関数テンプレート) [編集]
C のドキュメントacosh について)

[編集] 外部リンク

Weisstein, Eric W. "Inverse Hyperbolic Cosine." MathWorld — A Wolfram Web Resource より。
English 日本語 中文(简体) 中文(繁體)