std:: sin, std:: sinf, std:: sinl

パラメータ

戻り値

エラーが発生しない場合、 num の正弦（ sin(num) ）が範囲 [ - 1 , + 1 ] 内で返されます。

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

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

エラーハンドリング

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

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

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

注記

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

POSIXはまた、アンダーフローの場合、 num は変更されずに返され、それがサポートされていない場合、 DBL_MIN 、 FLT_MIN 、および LDBL_MIN を超えない実装定義の値が返されることを規定しています。

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

例

#include <cerrno>
#include <cfenv>
#include <cmath>
#include <iomanip>
#include <iostream>
// #pragma STDC FENV_ACCESS ON
const double pi = std::acos(-1); // or std::numbers::pi since C++20
constexpr double your_sin(double x)
{
    double sin{0}, pow{x};
    for (auto fac{1LLU}, n{1ULL}; n != 20; fac *= ++n, pow *= x)
        if (n & 1)
            sin += (n & 2 ? -pow : pow) / fac;
    return sin;
}
int main()
{
    std::cout << std::setprecision(10) << std::showpos
              << "一般的な使用例:\n"
              << "std::sin(pi/6) = " << std::sin(pi / 6) << '\n'
              << "your sin(pi/6) = " << your_sin(pi / 6) << '\n'
              << "std::sin(pi/2) = " << std::sin(pi / 2) << '\n'
              << "your sin(pi/2) = " << your_sin(pi / 2) << '\n'
              << "std::sin(-3*pi/4) = " << std::sin(-3 * pi / 4) << '\n'
              << "your sin(-3*pi/4) = " << your_sin(-3 * pi / 4) << '\n'
              << "特殊な値:\n"
              << "std::sin(+0) = " << std::sin(0.0) << '\n'
              << "std::sin(-0) = " << std::sin(-0.0) << '\n';
    // エラー処理
    std::feclearexcept(FE_ALL_EXCEPT);
    std::cout << "std::sin(INFINITY) = " << std::sin(INFINITY) << '\n';
    if (std::fetestexcept(FE_INVALID))
        std::cout << "    FE_INVALIDが発生しました\n";
}

一般的な使用例:
std::sin(pi/6) = +0.5
your sin(pi/6) = +0.5
std::sin(pi/2) = +1
your sin(pi/2) = +1
std::sin(-3*pi/4) = -0.7071067812
your sin(-3*pi/4) = -0.7071067812
特殊な値:
std::sin(+0) = +0
std::sin(-0) = -0
std::sin(INFINITY) = -nan
    FE_INVALIDが発生しました

関連項目