Namespaces
Variants

std:: tan, std:: tanf, std:: tanl

From cppreference.net
C++
Numerics library
Common mathematical functions
Nearest integer floating point operations
(C++11)
(C++11)
(C++11) (C++11) (C++11)
Floating point manipulation functions
(C++11) (C++11)
(C++11)
(C++11)
Classification and comparison
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Types
(C++11)
(C++11)
(C++11)
Macro constants
Definiert in Header <cmath>
(1)
float tan ( float num ) ;

double tan ( double num ) ;

long double tan ( long double num ) ;
(bis C++23)
/*floating-point-type*/
tan ( /*floating-point-type*/ num ) ;
(seit C++23)
(constexpr seit C++26)
float tanf ( float num ) ;
(2) (seit C++11)
(constexpr seit C++26)
long double tanl ( long double num ) ;
(3) (seit C++11)
(constexpr seit C++26)
SIMD-Überladung (seit C++26)
Definiert in Header <simd>
template < /*math-floating-point*/ V >

constexpr /*deduced-simd-t*/ < V >

tan ( const V & v_num ) ;
(S) (seit C++26)
Definiert in Header <cmath>
template < class Integer >
double tan ( Integer num ) ;
(A) (constexpr seit C++26)
1-3) Berechnet den Tangens von num (gemessen in Radiant). Die Bibliothek stellt Überladungen von std::tan für alle cv-unqualifizierten Gleitkommatypen als Typ des Parameters bereit. (since C++23)
S) Die SIMD-Überladung führt eine elementweise std::tan -Operation auf v_num aus.
(Siehe math-floating-point und deduced-simd-t für deren Definitionen.)
(seit C++26)
A) Zusätzliche Überladungen werden für alle Ganzzahltypen bereitgestellt, die als double behandelt werden.
(since C++11)

Inhaltsverzeichnis

Parameter

num - Fließkomma- oder Ganzzahlwert, der den Winkel im Bogenmaß darstellt

Rückgabewert

Wenn keine Fehler auftreten, wird der Tangens von num ( tan(num) ) zurückgegeben.

Das Ergebnis kann wenig oder keine Bedeutung haben, wenn die Größenordnung von num groß ist.

(until C++11)

Wenn ein Domänenfehler auftritt, wird ein implementierungsdefinierter Wert zurückgegeben (NaN, sofern unterstützt).

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

Fehlerbehandlung

Fehler werden gemeldet, wie in math_errhandling spezifiziert.

Wenn die Implementierung IEEE-Gleitkommaarithmetik (IEC 60559) unterstützt,

  • wenn das Argument ±0 ist, wird es unverändert zurückgegeben.
  • wenn das Argument ±∞ ist, wird NaN zurückgegeben und FE_INVALID ausgelöst.
  • wenn das Argument NaN ist, wird NaN zurückgegeben.

Hinweise

Der Fall, in dem das Argument unendlich ist, ist in C (auf das C++ verweist) nicht als Domänenfehler spezifiziert, aber es ist definiert als ein Domänenfehler in POSIX .

Die Funktion hat mathematische Pole bei π(1/2 + n) ; jedoch ist keine gängige Fließkommadarstellung in der Lage, π/2 exakt darzustellen, daher gibt es keinen Argumentwert, bei dem ein Polfehler auftritt.

Die zusätzlichen Überladungen müssen nicht exakt wie (A) bereitgestellt werden. Sie müssen lediglich sicherstellen, dass für ihr Argument num vom Ganzzahltyp std :: tan ( num ) die gleiche Wirkung hat wie std :: tan ( static_cast < double > ( num ) ) .

Beispiel

Diesen Code ausführen 
#include <cerrno>
#include <cfenv>
#include <cmath>
#include <iostream>
// #pragma STDC FENV_ACCESS ON
const double pi = std::acos(-1); // or C++20's std::numbers::pi
int main()
{
    // typische Verwendung
    std::cout << "tan(1*pi/4) = " << std::tan(1*pi/4) << '\n' // 45°
              << "tan(3*pi/4) = " << std::tan(3*pi/4) << '\n' // 135°
              << "tan(5*pi/4) = " << std::tan(5*pi/4) << '\n' // -135°
              << "tan(7*pi/4) = " << std::tan(7*pi/4) << '\n'; // -45°
    // spezielle Werte
    std::cout << "tan(+0) = " << std::tan(0.0) << '\n'
              << "tan(-0) = " << std::tan(-0.0) << '\n';
    // Fehlerbehandlung
    std::feclearexcept(FE_ALL_EXCEPT);
    std::cout << "tan(INFINITY) = " << std::tan(INFINITY) << '\n';
    if (std::fetestexcept(FE_INVALID))
        std::cout << "    FE_INVALID raised\n";
}

Mögliche Ausgabe: 

tan(1*pi/4) = 1
tan(3*pi/4) = -1
tan(5*pi/4) = 1
tan(7*pi/4) = -1
tan(+0) = 0
tan(-0) = -0
tan(INFINITY) = -nan
    FE_INVALID raised

Siehe auch

(C++11) (C++11)
berechnet Sinus ( sin(x) )
(Funktion)
(C++11) (C++11)
berechnet Kosinus ( cos(x) )
(Funktion)
(C++11) (C++11)
berechnet Arcustangens ( arctan(x) )
(Funktion)
berechnet Tangens einer komplexen Zahl ( tan(z) )
(Funktions-Template)
wendet die Funktion std::tan auf jedes Element des Valarray an
(Funktions-Template)
C-Dokumentation für tan