std:: tan, std:: tanf, std:: tanl

パラメータ

戻り値

エラーが発生しない場合、 num のタンジェント（ tan(num) ）が返されます。

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

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

エラーハンドリング

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

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

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

注記

引数が無限大の場合の扱いは、C言語（C++はこれに従う）では定義域エラーとして規定されていませんが、 POSIXでは定義域エラー として定義されています。

この関数は π(1/2 + n) に数学的な極を持つが、一般的な浮動小数点表現ではπ/2を正確に表現できないため、極エラーが発生する引数の値は存在しない。

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

例

#include <cerrno>
#include <cfenv>
#include <cmath>
#include <iostream>
// #pragma STDC FENV_ACCESS ON
const double pi = std::acos(-1); // or C++20's std::numbers::pi
int main()
{
    // 典型的な使用例
    std::cout << "tan(1*pi/4) = " << std::tan(1*pi/4) << '\n' // 45°
              << "tan(3*pi/4) = " << std::tan(3*pi/4) << '\n' // 135°
              << "tan(5*pi/4) = " << std::tan(5*pi/4) << '\n' // -135°
              << "tan(7*pi/4) = " << std::tan(7*pi/4) << '\n'; // -45°
    // 特殊な値
    std::cout << "tan(+0) = " << std::tan(0.0) << '\n'
              << "tan(-0) = " << std::tan(-0.0) << '\n';
    // エラー処理
    std::feclearexcept(FE_ALL_EXCEPT);
    std::cout << "tan(INFINITY) = " << std::tan(INFINITY) << '\n';
    if (std::fetestexcept(FE_INVALID))
        std::cout << "    FE_INVALID raised\n";
}

tan(1*pi/4) = 1
tan(3*pi/4) = -1
tan(5*pi/4) = 1
tan(7*pi/4) = -1
tan(+0) = 0
tan(-0) = -0
tan(INFINITY) = -nan
    FE_INVALID raised

関連項目