Namensräume
Varianten
Aktionen

tanh, tanhf, tanhl

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
(C23)
(C23)
(C23)
(C23)
tanh
(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       tanhf( float arg );
(1) (seit C99)
double      tanh( double arg );
(2)
long double tanhl( long double arg );
(3) (seit C99)
Definiert in Header <tgmath.h>
#define tanh( arg )
(4) (seit C99)
1-3) Berechnet den hyperbolischen Tangens von arg.
4) Typ-generische Makro: Wenn das Argument den Typ long double hat, wird tanhl aufgerufen. Andernfalls, wenn das Argument einen Ganzzahltyp oder den Typ double hat, wird tanh aufgerufen. Andernfalls wird tanhf aufgerufen. Wenn das Argument komplex ist, ruft das Makro die entsprechende komplexe Funktion auf (ctanhf, ctanh, ctanhl).

Inhalt

[bearbeiten] Parameter

arg - Gleitkommazahl, die einen hyperbolischen Winkel darstellt

[bearbeiten] Rückgabewert

Wenn keine Fehler auftreten, wird der hyperbolische Tangens von arg (tanh(arg) oder
earg
-e-arg
earg
+e-arg
) 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 ±0 zurückgegeben.
  • Wenn das Argument ±∞ ist, wird ±1 zurückgegeben.
  • Wenn das Argument NaN ist, wird NaN zurückgegeben.

[bearbeiten] Hinweise

POSIX schreibt vor, dass bei Underflow arg unverändert zurückgegeben wird. Wenn dies nicht unterstützt wird, wird ein implementierungsdefinierter Wert zurückgegeben, der nicht größer ist als DBL_MIN, FLT_MIN und LDBL_MIN.

[bearbeiten] Beispiel

#include <math.h>
#include <stdio.h>
 
int main(void)
{
    printf("tanh(1) = %f\ntanh(-1) = %f\n", tanh(1), tanh(-1));
    printf("tanh(0.1)*sinh(0.2)-cosh(0.2) = %f\n", tanh(0.1) * sinh(0.2) - cosh(0.2));
    // special values
    printf("tanh(+0) = %f\ntanh(-0) = %f\n", tanh(0.0), tanh(-0.0));
}

Ausgabe

tanh(1) = 0.761594
tanh(-1) = -0.761594
tanh(0.1)*sinh(0.2)-cosh(0.2) = -1.000000
tanh(+0) = 0.000000
tanh(-0) = -0.000000

[bearbeiten] Referenzen

  • C23-Standard (ISO/IEC 9899:2024)
  • 7.12.5.6 The tanh functions (p: TBD)
  • 7.25 Typ-generische Mathematik <tgmath.h> (S. TBD)
  • F.10.2.6 The tanh functions (p: TBD)
  • C17-Standard (ISO/IEC 9899:2018)
  • 7.12.5.6 The tanh functions (p: TBD)
  • 7.25 Typ-generische Mathematik <tgmath.h> (S. TBD)
  • F.10.2.6 The tanh functions (p: TBD)
  • C11-Standard (ISO/IEC 9899:2011)
  • 7.12.5.6 The tanh functions (p: 242)
  • 7.25 Typ-generische Mathematik <tgmath.h> (S. 373-375)
  • F.10.2.6 The tanh functions (p: 520)
  • C99-Standard (ISO/IEC 9899:1999)
  • 7.12.5.6 The tanh functions (p: 222-223)
  • 7.22 Typ-generische Mathematik <tgmath.h> (S. 335-337)
  • F.9.2.6 The tanh functions (p: 457)
  • C89/C90-Standard (ISO/IEC 9899:1990)
  • 4.5.3.3 The tanh function

[bearbeiten] Siehe auch

(C99)(C99)
berechnet Sinus hyperbolicus (sinh(x))
(Funktion) [bearbeiten]
(C99)(C99)
berechnet Kosinus hyperbolicus (cosh(x))
(Funktion) [bearbeiten]
(C99)(C99)(C99)
berechnet inversen Tangens hyperbolicus (artanh(x))
(Funktion) [bearbeiten]
(C99)(C99)(C99)
berechnet den komplexen hyperbolischen Tangens
(Funktion) [bearbeiten]