asin
、 asinf
、 asinl
アークサインを計算します。
構文
double asin( double x );
float asinf ( float x );
long double asinl( long double x );
#define asin(X) // Requires C11 or higher
float asin( float x ); // C++ only
long double asin( long double x ); // C++ only
パラメーター
x
アークサインが計算される値。
戻り値
asin
関数は、-π/2 ~ π/2 ラジアンの範囲で、x
のアークサイン (逆サイン関数) を返します。
既定では、x
が -1 未満または 1 よりも大きい場合、asin
では不定値を返します。
入力 | SEH 例外 | _matherr 例外 |
---|---|---|
± INF | INVALID |
_DOMAIN |
± QNaN、IND | なし | _DOMAIN |
|x| > 1 |
INVALID |
_DOMAIN |
解説
C++ ではオーバーロードが可能であるため、asin
および float
で long double
のオーバーロードを呼び出すことができます。 C プログラムでは、<tgmath.h>
マクロを使用してこの関数を呼び出す場合を除き、asin
では常に double
を受け取って返します。
<tgmath.h>
のasin
マクロを使用する場合、引数の型によって、選択される関数のバージョンが決まります。 詳細については、「ジェネリック型数値演算」を参照してください。
既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT でのグローバル状態」を参照してください。
要件
ルーチンによって返される値 | 必須ヘッダー (C) | 必須ヘッダー (C++) |
---|---|---|
asin 、 asinf 、 asinl |
<math.h> |
<cmath> または <math.h> |
asin マクロ |
<tgmath.h> |
例
詳細については、acos
、acosf
、acosl
に関する記事を参照してください。
関連項目
数値演算と浮動小数点のサポート
acos
、 acosf
、 acosl
atan
、 atanf
、 atanl
、 atan2
、 atan2f
、 atan2l
cos
、 cosf
、 cosl
_matherr
sin
、 sinf
、 sinl
tan
、 tanf
、 tanl