WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

atan2 — C23-Bibliotheksfunktion

`atan2(double y, double x)` aus `<math.h>` liefert den Richtungswinkel des Punktes `(x, y)` zur positiven x-Achse im Bogenmaß im Intervall von `-π` bis `π`. Die Argumentreihenfolge ist zuerst `y`, dann `x`.

Version: C23

Syntax

double atan2(double y, double x);

atan2(double y, double x) aus <math.h> liefert den Richtungswinkel des Punktes (x, y) zur positiven x-Achse im Bogenmaß im Intervall von -π bis π. Die Argumentreihenfolge ist zuerst y, dann x.

Anders als atan(y / x) bewahrt die Funktion den Quadranten und behandelt eine vertikale Richtung ohne Division. Das Beispiel ruft tatsächlich atan2(1.0, 0.0) auf und erhält ungefähr π/2.

Das grundlegende C23 erlaubt einen Definitionsbereichsfehler, wenn beide Argumente null sind; ein Bereichsfehler kann auftreten, wenn x > 0 und ein von null verschiedenes y / x so nahe bei null liegt, dass das korrekte Ergebnis unterläuft. Alle genauen Regeln für vorzeichenbehaftete Nullen, Unendlichkeitsquadranten und NaN gelten als Garantien von Annex F für IEC 60559, nicht des portablen C23-Kerns.

Beispiele

#include <math.h>
#include <stdio.h>

int main(void) {
    double radians = atan2(1.0, 0.0);
    printf("%.3f\n", radians);
    return 0;
}

Ergebnis

1.571

Anders als `atan(y / x)` bewahrt die Funktion den Quadranten und behandelt eine vertikale Richtung ohne Division. Das Beispiel ruft tatsächlich `atan2(1.0, 0.0)` auf und erhält ungefähr `π/2`.

Quellen