std:: acos, std:: acosf, std:: acosl

パラメータ

戻り値

エラーが発生しない場合、 num の逆余弦（ arccos(num) ）が範囲 [0, π] 内で返されます。

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

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

エラーハンドリング

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

ドメインエラーは、 num が範囲 [ - 1.0 , 1.0 ] の外側にある場合に発生します。

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

• 引数が +1 の場合、値 +0 が返されます。
• |num| > 1 の場合、定義域エラーが発生しNaNが返されます。
• 引数がNaNの場合、NaNが返されます。

注記

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

例

#include <cerrno>
#include <cfenv>
#include <cmath>
#include <cstring>
#include <iostream>
// #pragma STDC FENV_ACCESS ON
int main()
{
    std::cout << "acos(-1) = " << std::acos(-1) << '\n'
              << "acos(0.0) = " << std::acos(0.0) << '\n'
              << "2*acos(0.0) = " << 2 * std::acos(0) << '\n'
              << "acos(0.5) = " << std::acos(0.5) << '\n'
              << "3*acos(0.5) = " << 3 * std::acos(0.5) << '\n'
              << "acos(1) = " << std::acos(1) << '\n';
    // エラー処理
    errno = 0;
    std::feclearexcept(FE_ALL_EXCEPT);
    std::cout << "acos(1.1) = " << std::acos(1.1) << '\n';
    if (errno == EDOM)
        std::cout << "    errno == EDOM: " << std::strerror(errno) << '\n';
    if (std::fetestexcept(FE_INVALID))
        std::cout << "    FE_INVALID raised" << '\n';
}

acos(-1) = 3.14159
acos(0.0) = 1.5708
2*acos(0.0) = 3.14159
acos(0.5) = 1.0472
3*acos(0.5) = 3.14159
acos(1) = 0
acos(1.1) = nan
    errno == EDOM: Numerical argument out of domain
    FE_INVALID raised

関連項目