Namensräume
Varianten
Aktionen

std::cosh(std::complex)

Von cppreference.com
< cpp‎ | numeric‎ | complex
 
 
 
 
Definiert in der Header-Datei <complex>
template< class T >
complex<T> cosh( const complex<T>& z );
(seit C++11)

Berechnet den komplexen hyperbolischen Kosinus eines komplexen Wertes z.

Inhalt

[bearbeiten] Parameter

z - komplexer Wert

[bearbeiten] Rückgabewert

Wenn keine Fehler auftreten, wird der komplexe hyperbolische Kosinus von z zurückgegeben.

[bearbeiten] Fehlerbehandlung und Sonderwerte

Fehler werden konsistent mit math_errhandling gemeldet.

Wenn die Implementierung IEEE-Gleitkomma-Arithmetik unterstützt,

  • std::cosh(std::conj(z)) == std::conj(std::cosh(z))
  • std::cosh(z) == std::cosh(-z)
  • Wenn z (+0,+0) ist, ist das Ergebnis (1,+0).
  • Wenn z (+0,+∞) ist, ist das Ergebnis (NaN,±0) (das Vorzeichen des Imaginärteils ist undefiniert) und FE_INVALID wird ausgelöst.
  • Wenn z (+0,NaN) ist, ist das Ergebnis (NaN,±0) (das Vorzeichen des Imaginärteils ist undefiniert).
  • Wenn z (x,+∞) ist (für ein beliebiges endliches, ungleich Null x), ist das Ergebnis (NaN,NaN) und FE_INVALID wird ausgelöst.
  • Wenn z (x,NaN) ist (für ein beliebiges endliches, ungleich Null x), ist das Ergebnis (NaN,NaN) und FE_INVALID kann ausgelöst werden.
  • Wenn z (+∞,+0) ist, ist das Ergebnis (+∞,+0)
  • Wenn z (+∞,y) ist (für ein beliebiges endliches, ungleich Null y), ist das Ergebnis +∞cis(y).
  • Wenn z (+∞,+∞) ist, ist das Ergebnis (±∞,NaN) (das Vorzeichen des Realteils ist undefiniert) und FE_INVALID wird ausgelöst.
  • Wenn z (+∞,NaN) ist, ist das Ergebnis (+∞,NaN)
  • Wenn z (NaN,+0) ist, ist das Ergebnis (NaN,±0) (das Vorzeichen des Imaginärteils ist undefiniert).
  • Wenn z (NaN,+y) ist (für ein beliebiges endliches, ungleich Null y), ist das Ergebnis (NaN,NaN) und FE_INVALID kann ausgelöst werden.
  • Wenn z (NaN,NaN) ist, ist das Ergebnis (NaN,NaN)

wobei cis(y) gleich cos(y) + i sin(y) ist.

[bearbeiten] Anmerkungen

Die mathematische Definition des hyperbolischen Kosinus ist cosh z =
ez
+e-z
2
.

Der hyperbolische Kosinus ist eine ganze Funktion in der komplexen Ebene und hat keine Schnittstellen. Er ist bezüglich der imaginären Komponente periodisch mit der Periode 2πi.

[bearbeiten] Beispiele

#include <cmath>
#include <complex>
#include <iostream>
 
int main()
{   
    std::cout << std::fixed;
    std::complex<double> z(1.0, 0.0); // behaves like real cosh along the real line
    std::cout << "cosh" << z << " = " << std::cosh(z)
              << " (cosh(1) = " << std::cosh(1) << ")\n";
 
    std::complex<double> z2(0.0, 1.0); // behaves like real cosine along the imaginary line
    std::cout << "cosh" << z2 << " = " << std::cosh(z2)
              << " ( cos(1) = " << std::cos(1) << ")\n";
}

Ausgabe

cosh(1.000000,0.000000) = (1.543081,0.000000) (cosh(1) = 1.543081)
cosh(0.000000,1.000000) = (0.540302,0.000000) ( cos(1) = 0.540302)

[bearbeiten] Siehe auch

berechnet den hyperbolischen Sinus einer komplexen Zahl (sinh(z))
(function template) [edit]
berechnet den hyperbolischen Tangens einer komplexen Zahl (tanh(z))
(function template) [edit]
berechnet den Area Hyperbolicus Kosinus einer komplexen Zahl (arcosh(z))
(function template) [edit]
(C++11)(C++11)
berechnet den hyperbolischen Kosinus (cosh(x))
(Funktion) [bearbeiten]
wendet die Funktion std::cosh auf jedes Element des Valarrays an
(function template) [edit]
C-Dokumentation für ccosh