acos, acosf, acosl
提供: cppreference.com
ヘッダ <math.h> で定義 | ||
float acosf(float arg ); | (1) | (C99以上) |
double acos(double arg ); | (2) | |
longdouble acosl(longdouble arg ); | (3) | (C99以上) |
ヘッダ <tgmath.h> で定義 | ||
#define acos( arg ) | (4) | (C99以上) |
1-3)
arg の逆余弦の主値を計算します。4) 型総称マクロ。 引数が longdouble 型の場合は
acosl が呼ばれます。 そうでなく、引数が整数型または double 型の場合は acos が呼ばれます。 そうでなければ acosf が呼ばれます。 引数が複素数の場合、マクロは対応する複素数の関数 (cacosf, cacos, cacosl) を呼びます。目次 |
[編集]引数
| arg | - | 浮動小数点値 |
[編集]戻り値
エラーが発生しなければ、範囲 [0 ; π] 内の arg の逆余弦 (arccos(arg)) が返されます。
定義域エラーが発生した場合、処理系定義の値 (サポートされていれば NaN) が返されます。
アンダーフローによる値域エラーが発生した場合、 (丸めた後の) 正しい結果が返されます。
[編集]エラー処理
math_errhandling で規定されている通りにエラーが報告されます。
arg が範囲 [-1.0; 1.0] 外の場合、定義域エラーが発生します。
処理系が IEEE 浮動小数点算術 (IEC 60559) をサポートしている場合、
- 引数が +1 であれば、値
+0が返されます。 - |arg| > 1 であれば、定義域エラーが発生し、 NaN が返されます。
- 引数が NaN であれば、 NaN が返されます。
[編集]例
Run this code
#include <stdio.h>#include <math.h>#include <errno.h>#include <fenv.h>#include <string.h> #pragma STDC FENV_ACCESS ONint main(void){printf("acos(-1) = %f\n", acos(-1));printf("acos(0.0) = %f 2*acos(0.0) = %f\n", acos(0), 2*acos(0));printf("acos(0.5) = %f 3*acos(0.5) = %f\n", acos(0.5), 3*acos(0.5));printf("acos(1) = %f\n", acos(1));// error handling errno=0;feclearexcept(FE_ALL_EXCEPT);printf("acos(1.1) = %f\n", acos(1.1));if(errno==EDOM)perror(" errno == EDOM");if(fetestexcept(FE_INVALID))puts(" FE_INVALID raised");}
出力例:
acos(-1) = 3.141593 acos(0.0) = 1.570796 2*acos(0.0) = 3.141593 acos(0.5) = 1.047198 3*acos(0.5) = 3.141593 acos(1) = 0.000000 acos(1.1) = nan errno == EDOM: Numerical argument out of domain FE_INVALID raised
[編集]参考文献
- C11 standard (ISO/IEC 9899:2011):
- 7.12.4.1 The acos functions (p: 238)
- 7.25 Type-generic math <tgmath.h> (p: 373-375)
- F.10.1.1 The acos functions (p: 518)
- C99 standard (ISO/IEC 9899:1999):
- 7.12.4.1 The acos functions (p: 218)
- 7.22 Type-generic math <tgmath.h> (p: 335-337)
- F.9.1.1 The acos functions (p: 455)
- C89/C90 standard (ISO/IEC 9899:1990):
- 4.5.2.1 The acos function
[編集]関連項目
(C99)(C99) | 逆正弦 (arcsin(x)) を計算します (関数) |
(C99)(C99) | 逆正接 (arctan(x)) を計算します (関数) |
(C99)(C99) | 象限を判断するために符号を使用して逆正接を計算します (関数) |
(C99)(C99) | 余弦 (cos(x)) を計算します (関数) |
(C99)(C99)(C99) | 複素数の逆余弦を計算します (関数) |
acos の C++リファレンス | |
