atan2, atan2f, atan2l

パラメータ

戻り値

`, `$`タグ内ではないが、C++コードとして認識される部分は翻訳対象外\; -\; `y/x`はC++の演算式（除算）であり、C++特有の用語として翻訳せず保持\; -\; 元のフォーマットと構造を完全に維持$

Y引数

戻り値

X引数

定義域エラーが発生した場合、実装定義の値が返されます。

アンダーフローによる範囲エラーが発生した場合、正しい結果（丸め後）が返されます。

エラーハンドリング

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

x と y が両方ともゼロの場合、定義域エラーが発生する可能性があります。

IEEE浮動小数点演算（IEC 60559）が実装でサポートされている場合：

• x と y が両方ともゼロの場合、定義域エラーは 発生しない ；
• x と y が両方ともゼロの場合、値域エラーも発生しない；
• y がゼロの場合、極エラーは発生しない；
• y が ±0 で x が負または -0 の場合、 ±π が返される；
• y が ±0 で x が正または +0 の場合、 ±0 が返される；
• y が ±∞ で x が有限の場合、 ±π/2 が返される；
• y が ±∞ で x が -∞ の場合、 ±3π/4 が返される；
• y が ±∞ で x が +∞ の場合、 ±π/4 が返される；
• x が ±0 で y が負の場合、 -π/2 が返される；
• x が ±0 で y が正の場合、 +π/2 が返される；
• x が -∞ で y が有限かつ正の場合、 +π が返される；
• x が -∞ で y が有限かつ負の場合、 -π が返される；
• x が +∞ で y が有限かつ正の場合、 +0 が返される；
• x が +∞ で y が有限かつ負の場合、 -0 が返される；
• x または y のいずれかがNaNの場合、NaNが返される。

注記

atan2 ( y, x ) は carg ( x + I * y ) と等価です。

POSIXは アンダーフローが発生した場合、 y / x の値を返すことを規定しており、それがサポートされていない場合は、 DBL_MIN 、 FLT_MIN 、および LDBL_MIN を超えない実装定義の値が返されます。

例

#include <math.h>
#include <stdio.h>
int main(void)
{
    // 通常の使用法: 2つの引数の符号が象限を決定する
    // atan2(1,1) = +pi/4, 第I象限
    printf("(+1,+1) cartesian is (%f,%f) polar\n", hypot( 1, 1), atan2( 1, 1));
    // atan2(1, -1) = +3pi/4, 第II象限
    printf("(+1,-1) cartesian is (%f,%f) polar\n", hypot( 1,-1), atan2( 1,-1));
    // atan2(-1,-1) = -3pi/4, 第III象限
    printf("(-1,-1) cartesian is (%f,%f) polar\n", hypot(-1,-1), atan2(-1,-1));
    // atan2(-1,-1) = -pi/4, 第IV象限
    printf("(-1,+1) cartesian is (%f,%f) polar\n", hypot(-1, 1), atan2(-1, 1));
    // 特殊な値
    printf("atan2(0, 0) = %f atan2(0, -0)=%f\n", atan2(0,0), atan2(0,-0.0));
    printf("atan2(7, 0) = %f atan2(7, -0)=%f\n", atan2(7,0), atan2(7,-0.0));
}

(+1,+1) cartesian is (1.414214,0.785398) polar
(+1,-1) cartesian is (1.414214,2.356194) polar
(-1,-1) cartesian is (1.414214,-2.356194) polar
(-1,+1) cartesian is (1.414214,-0.785398) polar
atan2(0, 0) = 0.000000 atan2(0, -0)=3.141593
atan2(7, 0) = 1.570796 atan2(7, -0)=1.570796

参考文献

関連項目