atan2, atan2f, atan2l

Funktionen

Grundlegende Operationen

abslabsllabsimaxabs (C99)(C99)
fabs
divldivlldivimaxdiv (C99)(C99)

fmod
remainder (C99)
remquo (C99)
fma (C99)
fdim (C99)
nannanfnanlnandN (C99)(C99)(C99)(C23)

Maximum/Minimum-Operationen

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)

Exponentialfunktionen

exp
exp10 (C23)
exp2 (C99)
expm1 (C99)
exp10m1 (C23)
exp2m1 (C23)

log
log10
log2 (C99)
log1plogp1 (C99)(C23)
log10p1 (C23)
log2p1 (C23)

Potenzfunktionen

sqrt
cbrt (C99)
rootn (C23)
rsqrt (C23)

hypot (C99)
compound (C23)
pow
pown (C23)
powr (C23)

Trigonometrische und hyperbolische Funktionen

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)

Nächste ganze Gleitkommazahlen

ceil
floor
roundlroundllround (C99)(C99)(C99)
roundeven (C23)
trunc (C99)

nearbyint (C99)
rintlrintllrint (C99)(C99)(C99)
fromfpfromfpxufromfpufromfpx (C23)(C23)(C23)(C23)

Gleitkomma-Manipulation

ldexp
frexp
scalbnscalbln (C99)(C99)
ilogbllogb (C99)(C23)
logb (C99)

modf
nextafternexttoward (C99)(C99)
nextupnextdown (C23)(C23)
copysign (C99)
canonicalize (C23)

Verengende Operationen

fadd (C23)
fsub (C23)
fmul (C23)

fdiv (C23)
ffma (C23)
fsqrt (C23)

Quanten- und Quantenexponent-Funktionen

quantizedN (C23)
quantumdN (C23)

samequantumdN (C23)
llquantexpdN (C23)

Dezimal-Neu-Kodierungsfunktionen

encodedecdN (C23)
decodedecdN (C23)

encodebindN (C23)
decodebindN (C23)

Gesamtordnung und Payload-Funktionen

totalorder (C23)
getpayload (C23)

setpayload (C23)
setpayloadsig (C23)

Klassifizierung

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)

Fehler- und Gammafunktionen

erf (C99)
erfc (C99)

lgamma (C99)
tgamma (C99)

Typen

div_tldiv_tlldiv_timaxdiv_t

(C99)(C99)

float_tdouble_t (C99)(C99)
_Decimal32_t_Decimal64_t (C23)(C23)

Makrokonstanten

Spezielle Gleitkommawerte

HUGE_VALHUGE_VALFHUGE_VALLHUGE_VALDN

(C99)(C99)(C23)

INFINITYDEC_INFINITY (C99)(C23)
NANDEC_NAN (C99)(C23)

Argumente und Rückgabewerte

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)

Fehlerbehandlung

MATH_ERRNOMATH_ERRNOEXCEPT

(C99)(C99)

math_errhandling (C99)

Schnelle Operationsanzeigen

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)

[Bearbeiten]

Definiert in Header `<math.h>`
float atan2f( float y, float x );	(1)	(seit C99)
double atan2( double y, double x );	(2)
long double atan2l( long double y, long double x );	(3)	(seit C99)
_Decimal32 atan2d32( _Decimal32 y, _Decimal32 x );	(4)	(seit C23)
_Decimal64 atan2d64( _Decimal64 y, _Decimal64 x );	(5)	(seit C23)
_Decimal128 atan2d128( _Decimal128 y, _Decimal128 x );	(6)	(seit C23)
Definiert in Header `<tgmath.h>`
#define atan2( y, x )	(7)	(seit C99)

1-6) Berechnet den Arkustangens von y / x unter Verwendung der Vorzeichen der Argumente zur Bestimmung des korrekten Quadranten.

7) Typ-generische Makro: Wenn ein Argument den Typ long double hat, wird (3) (atan2l) aufgerufen. Andernfalls, wenn ein Argument einen ganzzahligen Typ oder den Typ double hat, wird (2) (atan2) aufgerufen. Andernfalls wird (1) (atan2f) aufgerufen.

Die Funktionen (4-6) werden nur dann deklariert, wenn die Implementierung __STDC_IEC_60559_DFP__ vordefiniert (d. h. die Implementierung unterstützt Dezimal-Gleitkommazahlen).

(seit C23)

[edit] Parameter

x, y

-

Gleitkommawert

[edit] Rückgabewert

Wenn keine Fehler auftreten, wird der Arkustangens von y / x (

arctan(y x)

) im Bereich

[-π ; +π]

Radiant zurückgegeben.

Y-Argument

Rückgabewert

$math-atan2.png$

X-Argument

Wenn ein Domänenfehler auftritt, wird ein implementierungsdefinierter Wert zurückgegeben.

Wenn ein Bereichsfehler aufgrund eines Unterlaufs auftritt, wird das korrekte Ergebnis (nach Rundung) zurückgegeben.

[edit] Fehlerbehandlung

Fehler werden wie in math_errhandling angegeben gemeldet.

Ein Domänenfehler kann auftreten, wenn x und y beide Null sind.

Wenn die Implementierung IEEE-Gleitkomma-Arithmetik (IEC 60559) unterstützt

Wenn x und y beide Null sind, tritt kein Domänenfehler auf;
Wenn x und y beide Null sind, tritt auch kein Bereichsfehler auf;
Wenn y Null ist, tritt kein Polfehler auf;
Wenn y ±0 ist und x negativ oder -0 ist, wird ±π zurückgegeben;
Wenn y ±0 ist und x positiv oder +0 ist, wird ±0 zurückgegeben;
Wenn y ±∞ ist und x endlich ist, wird ±π/2 zurückgegeben;
Wenn y ±∞ ist und x -∞ ist, wird ±3π/4 zurückgegeben;
Wenn y ±∞ ist und x +∞ ist, wird ±π/4 zurückgegeben;
Wenn x ±0 ist und y negativ ist, wird -π/2 zurückgegeben;
Wenn x ±0 ist und y positiv ist, wird +π/2 zurückgegeben;
Wenn x -∞ ist und y endlich und positiv ist, wird +π zurückgegeben;
Wenn x -∞ ist und y endlich und negativ ist, wird -π zurückgegeben;
Wenn x +∞ ist und y endlich und positiv ist, wird +0 zurückgegeben;
Wenn x +∞ ist und y endlich und negativ ist, wird -0 zurückgegeben;
Wenn entweder x NaN ist oder y NaN ist, wird NaN zurückgegeben.

[edit] Hinweise

atan2(y, x) ist äquivalent zu carg(x + I*y).

POSIX spezifiziert, dass im Falle eines Underflows y / x der zurückgegebene Wert ist, und wenn dies nicht unterstützt wird, ein implementierungsabhängiger Wert zurückgegeben wird, der nicht größer ist als DBL_MIN, FLT_MIN und LDBL_MIN.

[edit] Beispiel

Führen Sie diesen Code aus

#include <math.h>
#include <stdio.h>
 
int main(void)
{
    // normal usage: the signs of the two arguments determine the quadrant
    // atan2(1,1) = +pi/4, Quad I
    printf("(+1,+1) cartesian is (%f,%f) polar\n", hypot( 1, 1), atan2( 1, 1));
    // atan2(1, -1) = +3pi/4, Quad II
    printf("(+1,-1) cartesian is (%f,%f) polar\n", hypot( 1,-1), atan2( 1,-1));
    // atan2(-1,-1) = -3pi/4, Quad III
    printf("(-1,-1) cartesian is (%f,%f) polar\n", hypot(-1,-1), atan2(-1,-1));
    // atan2(-1,-1) = -pi/4, Quad IV
    printf("(-1,+1) cartesian is (%f,%f) polar\n", hypot(-1, 1), atan2(-1, 1));
 
    // special values
    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));
}

Ausgabe

(+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

[edit] Referenzen

C23-Standard (ISO/IEC 9899:2024)

7.12.4.4 Die atan2-Funktionen (S. TBD)

7.25 Typ-generische Mathematik <tgmath.h> (S. TBD)

F.10.1.4 Die atan2-Funktionen (S. TBD)

C17-Standard (ISO/IEC 9899:2018)

7.12.4.4 Die atan2-Funktionen (S. 174)

7.25 Typ-generische Mathematik <tgmath.h> (S. 272-273)

F.10.1.4 Die atan2-Funktionen (S. 378)

C11-Standard (ISO/IEC 9899:2011)

7.12.4.4 Die atan2-Funktionen (S. 239)

7.25 Typ-generische Mathematik <tgmath.h> (S. 373-375)

F.10.1.4 Die atan2-Funktionen (S. 519)

C99-Standard (ISO/IEC 9899:1999)

7.12.4.4 Die atan2-Funktionen (S. 219)

7.22 Typ-generische Mathematik <tgmath.h> (S. 335-337)

F.9.1.4 Die atan2-Funktionen (S. 456)

C89/C90-Standard (ISO/IEC 9899:1990)

4.5.2.4 Die atan2-Funktion

[edit] Siehe auch

asinasinfasinl (C99)(C99)	berechnet Arkussinus (${\small\arcsin{x} }$ $arcsin(x)$ ) (Funktion) [bearbeiten]
acosacosfacosl (C99)(C99)	berechnet Arkuskosinus (${\small\arccos{x} }$ $arccos(x)$ ) (Funktion) [bearbeiten]
atanatanfatanl (C99)(C99)	berechnet Arkustangens (${\small\arctan{x} }$ $arctan(x)$ ) (Funktion) [bearbeiten]
cargcargfcargl (C99)(C99)(C99)	berechnet den Phasenwinkel einer komplexen Zahl (Funktion) [bearbeiten]
C++-Dokumentation für atan2

Compiler-Unterstützung
Sprache
Header
Typunterstützung
Programm-Dienstprogramme
Unterstützung für variable Funktionsargumente
Fehlerbehandlung
Dynamische Speicherverwaltung
Bibliothek für Zeichenketten
Algorithmen
Numerik
Datums- und Zeitdienstprogramme
Ein-/Ausgabeunterstützung
Lokalisierungsunterstützung
Unterstützung für Nebenläufigkeit (C11)
Technische Spezifikationen
Symbolindex

Allgemeine mathematische Funktionen
Gleitkomma-Umgebung (C99)
Pseudozufallszahlengenerierung
Komplexe Arithmetik (C99)
Typ-generierte Mathematik (C99)
Bitmanipulation (C23)
Geprüfte Ganzzahl-Arithmetik (C23)

cppreference.com

Namensräume

Varianten

Ansichten

Aktionen