名前空間
変種
操作

sin, sinf, sinl

提供: cppreference.com
< c‎ | numeric‎ | math
 
 
 
一般的な数学関数
関数
基本操作
(C99)
(C99)
(C99)
(C99)
(C99)
(C99)(C99)(C99)
指数関数
(C99)
(C99)
(C99)
(C99)
冪関数
(C99)
(C99)
三角関数と双曲線関数
(C99)
(C99)
(C99)
誤差関数とガンマ関数
(C99)
(C99)
(C99)
(C99)
最も近い整数
(C99)(C99)(C99)
(C99)
(C99)(C99)(C99)
浮動小数点操作関数
(C99)(C99)
(C99)
(C99)
分類
(C99)
(C99)
(C99)
(C99)(C99)
マクロ定数
 
ヘッダ <math.h> で定義
float       sinf( float arg );
(1) (C99以上)
double      sin( double arg );
(2)
long double sinl( long double arg );
(3) (C99以上)
ヘッダ <tgmath.h> で定義
#define sin( arg )
(4) (C99以上)
1-3) (ラジアンで測った) arg の正弦を計算します。
4) 型総称マクロ。 引数が long double 型の場合は sinl が呼ばれます。 そうでなく、引数が整数型または double 型の場合は sin が呼ばれます。 そうでなければ sinf が呼ばれます。 引数が複素数の場合、マクロは対応する複素数の関数 (csinf, csin, csinl) を呼びます。

目次

[編集] 引数

arg - ラジアンで角度を表す浮動小数点値

[編集] 戻り値

エラーが発生しなければ、範囲 [-1 ; +1] 内の arg の正弦 (sin(arg)) を返します。

arg の絶対値が大きい場合、結果の有効桁数が少なくなったり無くなったりすることがあります。

(C99未満)

定義域エラーが発生した場合、処理系定義の値 (サポートされていれば NaN) が返されます。

アンダーフローによる値域エラーが発生した場合、 (丸めの後の) 正しい結果が返されます。

[編集] エラー処理

math_errhandling で規定されている通りにエラーが報告されます。

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

  • 引数が ±0 であれば、それが変更されずに返されます。
  • 引数が ±∞ であれば、 NaN が返され、 FE_INVALID が発生します。
  • 引数が NaN であれば、 NaN が返されます。

[編集] ノート

引数が無限大のケースは C では定義域エラーであると規定されていませんが、 POSIX では定義域エラーとして定義されています

POSIX はまた、アンダーフローの場合、 arg は変更されずに返され、それがサポートされていない場合、 DBL_MIN、 FLT_MIN、 LDBL_MIN より大きくない処理系定義の値が返されると規定しています。

[編集]

#include <stdio.h>
#include <math.h>
#include <errno.h>
#include <fenv.h>
 
#pragma STDC FENV_ACCESS ON
int main(void)
{
    double pi = acos(-1);
    // typical usage
    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));
    // special values
    printf("sin(+0) = %f\n", sin(0.0));
    printf("sin(-0) = %f\n", sin(-0.0));
    // error handling 
    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

[編集] 参考文献

  • C11 standard (ISO/IEC 9899:2011):
  • 7.12.4.6 The sin functions (p: 239-240)
  • 7.25 Type-generic math <tgmath.h> (p: 373-375)
  • F.10.1.6 The sin functions (p: 519)
  • C99 standard (ISO/IEC 9899:1999):
  • 7.12.4.6 The sin functions (p: 220)
  • 7.22 Type-generic math <tgmath.h> (p: 335-337)
  • F.9.1.6 The sin functions (p: 456)
  • C89/C90 standard (ISO/IEC 9899:1990):
  • 4.5.2.6 The sin function

[編集] 関連項目

(C99)(C99)
余弦 (cos(x)) を計算します
(関数) [edit]
(C99)(C99)
正接 (tan(x)) を計算します
(関数) [edit]
(C99)(C99)
逆正弦 (arcsin(x)) を計算します
(関数) [edit]
(C99)(C99)(C99)
複素正弦を計算します
(関数) [edit]