アークサインを計算します。
構文
double asin( double x );
float asinf ( float x );
long double asinl( long double x );
#define asin(X) // Requires C11 or later
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