std::tanh, std::tanhf, std::tanhl

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Numerik-Bibliothek

Allgemeine mathematische Funktionen
Mathematische Spezialfunktionen (C++17)
Mathematische Konstanten (C++20)
Grundlegende lineare Algebra-Algorithmen (C++26)
Datenparallele Typen (SIMD) (C++26)
Gleitkomma-Umgebung (C++11)
Komplexe Zahlen
Numerische Arrays (valarray)
Pseudozufallszahlengenerierung
Bit-Manipulation (C++20)
Faktoroperationen
gcd (C++17)	lcm (C++17)
Interpolationen
midpoint (C++20)	lerp (C++20)
Sättigungsarithmetik
add_sat (C++26) sub_sat (C++26) saturate_cast (C++26)	mul_sat (C++26) div_sat (C++26)
Generische numerische Operationen
iota (C++11) ranges::iota (C++23) accumulate inner_product adjacent_difference    partial_sum	reduce (C++17) transform_reduce (C++17) inclusive_scan (C++17) exclusive_scan (C++17) transform_inclusive_scan (C++17) transform_exclusive_scan (C++17)

 

Allgemeine mathematische Funktionen

Funktionen
Grundlegende Operationen
abs(int)labsllabsimaxabs (C++11)   abs(float)fabs divldivlldivimaxdiv (C++11)	fmod remainder (C++11)   remquo (C++11) fma (C++11) fmax (C++11) fmin (C++11) fdim (C++11) nannanfnanl (C++11)(C++11)(C++11)
Exponentialfunktionen
exp exp2 (C++11) expm1 (C++11)	log log10 log1p (C++11) log2 (C++11)
Potenzfunktionen
sqrt cbrt (C++11)	hypot (C++11) pow
Trigonometrische und hyperbolische Funktionen
sin cos tan asin acos atan atan2	sinh cosh tanh asinh (C++11) acosh (C++11) atanh (C++11)
Fehler- und Gammafunktionen
erf (C++11) erfc (C++11)	lgamma (C++11) tgamma (C++11)

Rundungsoperationen für Gleitkommazahlen
ceil floor roundlroundllround (C++11)(C++11)(C++11)	trunc (C++11) nearbyint (C++11) rintlrintllrint (C++11)(C++11)(C++11)
Gleitkomma-Manipulationsfunktionen
ldexp scalbnscalbln (C++11)(C++11) ilogb (C++11) logb (C++11)	frexp modf nextafternexttoward (C++11)(C++11) copysign (C++11)
Klassifizierung und Vergleich
fpclassify (C++11) isfinite (C++11) isinf (C++11) isnan (C++11) isnormal (C++11) signbit (C++11)	isgreater (C++11) isgreaterequal (C++11) isless (C++11) islessequal (C++11) islessgreater (C++11) isunordered (C++11)
Typen
div_t ldiv_t lldiv_t (C++11)	imaxdiv_t (C++11) float_t (C++11) double_t (C++11)
Makrokonstanten
HUGE_VALFHUGE_VALHUGE_VALL (C++11)(C++11) math_errhandlingMATH_ERRNOMATH_ERREXCEPT (C++11)   INFINITY (C++11) NAN (C++11)	Klassifizierung FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C++11)(C++11)(C++11)(C++11)(C++11)

 

Definiert in der Header-Datei <cmath>
	(1)
float       tanh ( float num ); double      tanh ( double num ); long double tanh ( long double num );			(bis C++23)
/* Gleitkommazahl-Typ */             tanh ( /*Gleitkommatyp*/ num );			(seit C++23) (constexpr seit C++26)
float       tanhf( float num );		(2)	(seit C++11) (constexpr seit C++26)
long double tanhl( long double num );		(3)	(seit C++11) (constexpr seit C++26)
SIMD-Überladung (seit C++26)
Definiert im Header <simd>
template< /*math-floating-point*/ V > constexpr /*deduzierter-simd-t*/<V>             tanh ( const V& v_num );		(S)	(seit C++26)
Zusätzliche Überladungen (seit C++11)
Definiert in der Header-Datei <cmath>
template< class Integer > double      tanh ( Integer num );		(A)	(constexpr seit C++26)

1-3) Berechnet den hyperbolischen Tangens von num. Die Bibliothek stellt Überladungen von std::tanh für alle cv-unqualifizierten Gleitkommatypen als Parametertyp bereit.(seit C++23)

S) Die SIMD-Überladung führt ein elementweises std::tanh auf v_num aus. (Siehe math-floating-point und deduced-simd-t für ihre Definitionen.)

(seit C++26)

A) Zusätzliche Überladungen werden für alle ganzzahligen Typen bereitgestellt, die als double behandelt werden.

(seit C++11)

Parameter

num

-

Gleitkomma- oder Ganzzahlwert

Rückgabewert

Wenn keine Fehler auftreten, wird der hyperbolische Tangens von num (tanh(num) oder

enum -e-num

enum +e-num

) zurückgegeben.

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

Fehlerbehandlung

Fehler werden wie in math_errhandling beschrieben gemeldet.

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

• Wenn das Argument ±0 ist, wird ±0 zurückgegeben.
• Wenn das Argument ±∞ ist, wird ±1 zurückgegeben.
• Wenn das Argument NaN ist, wird NaN zurückgegeben.

Hinweise

POSIX legt fest, dass im Falle eines Unterlaufs num unverändert zurückgegeben wird, und wenn dies nicht unterstützt wird, ein implementierungsdefinierter Wert nicht größer als DBL_MIN, FLT_MIN und LDBL_MIN zurückgegeben wird.

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

Beispiel

Führen Sie diesen Code aus

#include <cmath>
#include <iostream>
#include <random>
 
double get_random_between(double min, double max)
{
    std::random_device rd;
    std::mt19937 gen(rd());
    return std::uniform_real_distribution<>(min, max)(gen);
}
 
int main()
{
    const double x = get_random_between(-1.0, 1.0);
 
    std::cout << std::showpos
              << "tanh(+1) = " << std::tanh(+1) << '\n'
              << "tanh(-1) = " << std::tanh(-1) << '\n'
              << "tanh(x)*sinh(2*x)-cosh(2*x) = "
              << std::tanh(x) * std::sinh(2 * x) - std::cosh(2 * x) << '\n'
              // special values:
              << "tanh(+0) = " << std::tanh(+0.0) << '\n'
              << "tanh(-0) = " << std::tanh(-0.0) << '\n';
}

Ausgabe

tanh(+1) = +0.761594
tanh(-1) = -0.761594
tanh(x)*sinh(2*x)-cosh(2*x) = -1
tanh(+0) = +0
tanh(-0) = -0

Siehe auch

sinhsinhfsinhl (C++11)(C++11)	berechnet den hyperbolischen Sinus (\({\small\sinh{x}}\)sinh(x)) (Funktion)
coshcoshfcoshl (C++11)(C++11)	berechnet den hyperbolischen Kosinus (\({\small\cosh{x}}\)cosh(x)) (Funktion)
atanhatanhfatanhl (C++11)(C++11)(C++11)	berechnet den inversen hyperbolischen Tangens (\({\small\operatorname{artanh}{x}}\)artanh(x)) (Funktion)
tanh(std::complex)	berechnet den hyperbolischen Tangens einer komplexen Zahl (\({\small\tanh{z}}\)tanh(z)) (function template)
tanh(std::valarray)	wendet die Funktion std::tanh auf jedes Element von valarray an (function template)
C-Dokumentation für tanh