sin, sinf, sinl

パラメータ

戻り値

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

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

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

エラーハンドリング

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

IEEE浮動小数点演算（IEC 60559）がサポートされている実装の場合：

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

注記

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

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

例

#include <errno.h>
#include <fenv.h>
#include <math.h>
#include <stdio.h>
#ifndef __GNUC__
#pragma STDC FENV_ACCESS ON
#endif
int main(void)
{
    const double pi = acos(-1);
    // 典型的な使用例
    printf("sin(pi/6) = %f\n", sin(pi / 6));
    printf("sin(pi/2) = %f\n", sin(pi / 2));
    printf("sin(-3*pi/4) = %f\n", sin(-3 * pi / 4));
    // 特殊な値
    printf("sin(+0) = %f\n", sin(0.0));
    printf("sin(-0) = %f\n", sin(-0.0));
    // エラー処理
    feclearexcept(FE_ALL_EXCEPT);
    printf("sin(INFINITY) = %f\n", sin(INFINITY));
    if (fetestexcept(FE_INVALID))
        puts("    FE_INVALID raised");
}

sin(pi/6) = 0.500000
sin(pi/2) = 1.000000
sin(-3*pi/4) = -0.707107
sin(+0) = 0.000000
sin(-0) = -0.000000
sin(INFINITY) = -nan
    FE_INVALID raised

参考文献

関連項目