Namensräume
Varianten
Aktionen

atan, atanf, atanl

Von cppreference.com
< c‎ | numerik‎ | math
 
 
 
Allgemeine mathematische Funktionen
Funktionen
Grundlegende Operationen
(C99)
(C99)
(C99)
(C99)(C99)(C99)(C23)
Maximum/Minimum-Operationen
(C99)
(C99)
Exponentialfunktionen
(C23)
(C99)
(C99)
(C23)
(C23)

(C99)
(C99)(C23)
(C23)
(C23)
Potenzfunktionen
(C99)
(C23)
(C23)

(C99)
(C23)
(C23)
Trigonometrische und hyperbolische Funktionen
atan
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
(C99)
(C99)
(C99)
Nächste ganze Gleitkommazahlen
(C99)(C99)(C99)
(C99)

(C99)(C99)(C99)
(C23)(C23)(C23)(C23)
Gleitkomma-Manipulation
(C99)(C99)
(C99)(C23)
(C99)
Verengende Operationen
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
Quanten- und Quantenexponent-Funktionen
Dezimal-Neu-Kodierungsfunktionen
Gesamtordnung und Payload-Funktionen
Klassifizierung
(C99)
(C99)
(C99)
(C23)
Fehler- und Gammafunktionen
(C99)
(C99)
(C99)
(C99)
Typen
Makrokonstanten
Spezielle Gleitkommawerte
(C99)(C23)
Argumente und Rückgabewerte
Fehlerbehandlung
Schnelle Operationsanzeigen
 
Definiert in Header <math.h>
float       atanf( float arg );
(1) (seit C99)
double      atan( double arg );
(2)
long double atanl( long double arg );
(3) (seit C99)
_Decimal32  atand32( _Decimal32 arg );
(4) (seit C23)
_Decimal64  atand64( _Decimal64 arg );
(5) (seit C23)
_Decimal128 atand128( _Decimal128 arg );
(6) (seit C23)
Definiert in Header <tgmath.h>
#define atan( arg )
(7) (seit C99)
1-6) Berechnet den Hauptwert des Arkustangens von arg.
7) Typ-generische Makro: Wenn das Argument vom Typ long double ist, wird (3) (atanl) aufgerufen. Andernfalls, wenn das Argument einen ganzzahligen Typ oder den Typ double hat, wird (2) (atan) aufgerufen. Andernfalls wird (1) (atanf) aufgerufen. Wenn das Argument komplex ist, ruft das Makro die entsprechende komplexe Funktion auf (catanf, catan, catanl).

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)

Inhalt

[bearbeiten] Parameter

arg - Gleitkommawert

[bearbeiten] Rückgabewert

Wenn keine Fehler auftreten, wird der Arkustangens von arg (arctan(arg)) im Bereich [-
π
2
 ; +
π
2
]
Radiant zurückgegeben.

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

[bearbeiten] Fehlerbehandlung

Fehler werden wie in math_errhandling angegeben gemeldet.

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

  • wenn das Argument ±0 ist, wird es unverändert zurückgegeben;
  • Wenn das Argument +∞ ist, wird +π/2 zurückgegeben;
  • Wenn das Argument -∞ ist, wird -π/2 zurückgegeben;
  • Wenn das Argument NaN ist, wird NaN zurückgegeben.

[bearbeiten] Hinweise

POSIX spezifiziert, dass im Falle von Underflow arg unverändert zurückgegeben wird, und wenn dies nicht unterstützt wird, ein implementierungsabhängiger Wert, der nicht größer als DBL_MIN, FLT_MIN und LDBL_MIN ist, zurückgegeben wird.

[bearbeiten] Beispiel

#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));
}

Ausgabe

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

[bearbeiten] Referenzen

  • C23-Standard (ISO/IEC 9899:2024)
  • 7.12.4.3 The atan functions (p: TBD)
  • 7.25 Typ-generische Mathematik <tgmath.h> (S. TBD)
  • F.10.1.3 The atan functions (p: TBD)
  • C17-Standard (ISO/IEC 9899:2018)
  • 7.12.4.3 The atan functions (p: 174)
  • 7.25 Typ-generische Mathematik <tgmath.h> (S. 272-273)
  • F.10.1.3 The atan functions (p: 378)
  • C11-Standard (ISO/IEC 9899:2011)
  • 7.12.4.3 The atan functions (p: 238-239)
  • 7.25 Typ-generische Mathematik <tgmath.h> (S. 373-375)
  • F.10.1.3 The atan functions (p: 519)
  • C99-Standard (ISO/IEC 9899:1999)
  • 7.12.4.3 The atan functions (p: 219)
  • 7.22 Typ-generische Mathematik <tgmath.h> (S. 335-337)
  • F.9.1.3 The atan functions (p: 456)
  • C89/C90-Standard (ISO/IEC 9899:1990)
  • 4.5.2.3 The atan function

[bearbeiten] Siehe auch

berechnet Arkustangens und verwendet Vorzeichen zur Bestimmung der Quadranten
(Funktion) [bearbeiten]
(C99)(C99)
berechnet Arkussinus (arcsin(x))
(Funktion) [bearbeiten]
(C99)(C99)
berechnet Arkuskosinus (arccos(x))
(Funktion) [bearbeiten]
(C99)(C99)
berechnet Tangens (tan(x))
(Funktion) [bearbeiten]
(C99)(C99)(C99)
berechnet den komplexen Arkustangens
(Funktion) [bearbeiten]