atan, atanf, atanl

 

C

コンパイラサポート

言語

ヘッダー

型サポート

プログラムユーティリティ

可変長引数関数のサポート

エラーハンドリング

動的メモリ管理

文字列ライブラリ

アルゴリズム

数値

日付と時刻のユーティリティ

入出力サポート

ローカライゼーションサポート

並行処理サポート (C11)

技術仕様

シンボルインデックス

 

数値

共通の数学関数

浮動小数点環境 (C99)

擬似乱数生成

複素数演算 (C99)

型ジェネリックな数学関数 (C99)

ビット操作 (C23)

整数オーバーフロー検査 (C23)

 

共通の数学関数

関数 基本的な数学関数 abslabsllabsimaxabs (C99)(C99) fabs divldivlldivimaxdiv (C99)(C99) fmod remainder (C99) remquo (C99) fma (C99) fdim (C99) nannanfnanlnandN (C99)(C99)(C99)(C23) 最大/最小演算 fmax (C99) fmin (C99) fmaximum (C23) fminimum (C23) fmaximum_mag (C23)  fmaximum_num (C23) fminimum_mag (C23) fminimum_num (C23) fmaximum_mag_num (C23) fminimum_mag_num (C23)   指数関数 exp exp10 (C23) exp2 (C99) expm1 (C99) exp10m1 (C23) exp2m1 (C23) log log10 log2 (C99) log1plogp1 (C99)(C23) log10p1 (C23) log2p1 (C23) べき乗関数 sqrt cbrt (C99) rootn (C23) rsqrt (C23) hypot (C99) compound (C23) pow pown (C23) powr (C23) 三角関数と双曲線関数 sin cos tan asin acos atan atan2 sinpi (C23) cospi (C23) tanpi (C23) asinpi (C23) acospi (C23) atanpi (C23) atan2pi (C23) sinh cosh tanh asinh (C99) acosh (C99) atanh (C99)

最も近い整数浮動小数点数 ceil floor roundlroundllround (C99)(C99)(C99) roundeven (C23) trunc (C99) nearbyint (C99) rintlrintllrint (C99)(C99)(C99) fromfpfromfpxufromfpufromfpx (C23)(C23)(C23)(C23) 浮動小数点操作 ldexp frexp scalbnscalbln (C99)(C99) ilogbllogb (C99)(C23) logb (C99) modf nextafternexttoward (C99)(C99) nextupnextdown (C23)(C23) copysign (C99) canonicalize (C23) 縮小演算 fadd (C23) fsub (C23) fmul (C23) fdiv (C23) ffma (C23) fsqrt (C23) 量子および量子指数 quantizedN (C23) quantumdN (C23) samequantumdN (C23) llquantexpdN (C23) Decimal再エンコーディング関数 encodedecdN (C23) decodedecdN (C23) encodebindN (C23) decodebindN (C23) 総順序およびペイロード関数 totalorder (C23) getpayload (C23) setpayload (C23) setpayloadsig (C23) 分類 fpclassify (C99) iscanonical (C23)  isfinite (C99) isinf (C99) isnan (C99) isnormal (C99) signbit (C99) issubnormal (C23) iszero (C23) isgreater (C99) isgreaterequal (C99)   isless (C99) islessequal (C99) islessgreater (C99) isunordered (C99) issignaling (C23) iseqsig (C23)

誤差関数とガンマ関数 erf (C99) erfc (C99) lgamma (C99) tgamma (C99) 型 div_tldiv_tlldiv_timaxdiv_t (C99)(C99) float_tdouble_t (C99)(C99) _Decimal32_t_Decimal64_t (C23)(C23) マクロ定数 特殊な浮動小数点値 HUGE_VALHUGE_VALFHUGE_VALLHUGE_VALDN (C99)(C99)(C23) INFINITYDEC_INFINITY (C99)(C23) NANDEC_NAN (C99)(C23) 引数と戻り値 FP_ILOGB0FP_ILOGBNAN (C99)(C99) FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C99)(C99)(C99)(C99)(C99) FP_LLOGB0FP_LLOGBNAN (C23)(C23) FP_INT_UPWARDFP_INT_DOWNWARDFP_INT_TOWARDZEROFP_INT_TONEARESTFROMZEROFP_INT_TONEAREST (C23)(C23)(C23)(C23)(C23) エラーハンドリング MATH_ERRNOMATH_ERRNOEXCEPT (C99)(C99)  math_errhandling (C99) 高速演算インジケータ FP_FAST_FMAFFP_FAST_FMA (C99)(C99) FP_FAST_FADDFP_FAST_FADDLFP_FAST_DADDLFP_FAST_DMADDDN (C23)(C23)(C23)(C23) FP_FAST_FMULFP_FAST_FMULLFP_FAST_DMULLFP_FAST_DMMULDN (C23)(C23)(C23)(C23) FP_FAST_FFMAFP_FAST_FFMALFP_FAST_DFMALFP_FAST_DMFMADN (C23)(C23)(C23)(C23) FP_FAST_FMALFP_FAST_FMADN (C99)(C23) FP_FAST_FSUBFP_FAST_FSUBLFP_FAST_DSUBLFP_FAST_DMSUBDN (C23)(C23)(C23)(C23) FP_FAST_FDIVFP_FAST_FDIVLFP_FAST_DDIVLFP_FAST_DMDIVDN (C23)(C23)(C23)(C23) FP_FAST_FSQRTFP_FAST_FSQRTLFP_FAST_DSQRTLFP_FAST_DMSQRTDN (C23)(C23)(C23)(C23)

 

ヘッダー <math.h> で定義
float       atanf( float arg );	(1)	(C99以降)
double      atan( double arg );	(2)
long double atanl( long double arg );	(3)	(C99以降)
_Decimal32  atand32( _Decimal32 arg );	(4)	(C23以降)
_Decimal64  atand64( _Decimal64 arg );	(5)	(C23以降)
_Decimal128 atand128( _Decimal128 arg );	(6)	(C23以降)
ヘッダー <tgmath.h> で定義
#define atan( arg )	(7)	(C99以降)

1-6) arg の主値であるアークタンジェントを計算します。

7) 型汎用マクロ：引数の型が long double の場合、(3) (atanl) が呼び出されます。それ以外の場合で、引数の型が整数型または double の場合、(2) (atan) が呼び出されます。それ以外の場合、(1) (atanf) が呼び出されます。引数が複素数の場合、マクロは対応する複素数関数 (catanf, catan, catanl) を呼び出します。

関数 (4-6) は、実装が __STDC_IEC_60559_DFP__ を事前定義している場合（つまり、実装が10進浮動小数点数をサポートしている場合）にのみ宣言されます。

(C23以降)

パラメータ

arg

-

floating-point value

戻り値

エラーが発生しなかった場合、arg のアークタンジェント (arctan(arg)) が、ラジアン単位で [-

π

2

 ; +

π

2

] の範囲で返されます。

アンダーフローによる範囲エラーが発生した場合、正確な結果 (丸め後) が返される。

エラー処理

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

実装が IEEE 浮動小数点演算 (IEC 60559) をサポートしている場合

• 引数が ±0 の場合、変更されずに返されます。
• 引数が +∞ の場合、+π/2 が返されます。
• 引数が -∞ の場合、-π/2 が返されます。
• 引数が NaN の場合、NaN が返されます。

注記

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

例

このコードを実行

#include <math.h>
#include <stdio.h>
 
int main(void)
{
    printf("atan(1) = %f, 4*atan(1)=%f\n", atan(1), 4 * atan(1));
    // special values
    printf("atan(Inf) = %f, 2*atan(Inf) = %f\n", atan(INFINITY), 2 * atan(INFINITY));
    printf("atan(-0.0) = %+f, atan(+0.0) = %+f\n", atan(-0.0), atan(0));
}

出力

atan(1) = 0.785398, 4*atan(1)=3.141593
atan(Inf) = 1.570796, 2*atan(Inf) = 3.141593
atan(-0.0) = -0.000000, atan(+0.0) = +0.000000

参考文献

• C23標準 (ISO/IEC 9899:2024)

• 7.12.4.3 atan 関数 (p: TBD)

• 7.25 Type-generic math <tgmath.h> (p: TBD)

• F.10.1.3 atan 関数 (p: TBD)

• C17標準 (ISO/IEC 9899:2018)

• 7.12.4.3 atan 関数 (p: 174)

• 7.25 型総称数学関数 <tgmath.h> (p: 272-273)

• F.10.1.3 atan 関数 (p: 378)

• C11標準 (ISO/IEC 9899:2011)

• 7.12.4.3 atan 関数 (p: 238-239)

• 7.25 型総称数学関数 <tgmath.h> (p: 373-375)

• F.10.1.3 atan 関数 (p: 519)

• C99標準 (ISO/IEC 9899:1999)

• 7.12.4.3 atan 関数 (p: 219)

• 7.22 型総称数学関数 <tgmath.h> (p: 335-337)

• F.9.1.3 atan 関数 (p: 456)

• C89/C90標準 (ISO/IEC 9899:1990)

• 4.5.2.3 atan 関数

関連項目

atan2atan2fatan2l (C99)(C99)	象限を決定するために符号を使用してアークタンジェントを計算する (関数)
asinasinfasinl (C99)(C99)	アークサインを計算する (\({\small\arcsin{x} }\)arcsin(x)) (関数)
acosacosfacosl (C99)(C99)	アークコサインを計算する (\({\small\arccos{x} }\)arccos(x)) (関数)
tantanftanl (C99)(C99)	タンジェントを計算する (\({\small\tan{x} }\)tan(x)) (関数)
catancatanfcatanl (C99)(C99)(C99)	複素アークタンジェントを計算する (関数)
C++ ドキュメント (atan)