Namespaces
Variants

std:: acosh, std:: acoshf, std:: acoshl

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 acosh ( float num ) ;

double acosh ( double num ) ;

long double acosh ( long double num ) ;
(bis C++23)
/*floating-point-type*/
acosh ( /*floating-point-type*/ num ) ;
(seit C++23)
(constexpr seit C++26)
float acoshf ( float num ) ;
(2) (seit C++11)
(constexpr seit C++26)
long double acoshl ( 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 >

acosh ( const V & v_num ) ;
(S) (seit C++26)
Definiert in Header <cmath>
template < class Integer >
double acosh ( Integer num ) ;
(A) (constexpr seit C++26)
1-3) Berechnet den inversen hyperbolischen Kosinus von num . Die Bibliothek stellt Überladungen von std::acosh für alle cv-unqualifizierten Gleitkommatypen als Typ des Parameters bereit. (since C++23)
S) Die SIMD-Überladung führt eine elementweise std::acosh -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 - Gleitkomma- oder Ganzzahlwert

Rückgabewert

Wenn keine Fehler auftreten, wird der inverse hyperbolische Kosinus von num ( cosh -1
(num) , oder arcosh(num) ) auf dem Intervall [0, +∞] zurückgegeben.

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

Fehlerbehandlung

Fehler werden gemeldet, wie in math_errhandling spezifiziert.

Wenn das Argument kleiner als 1 ist, tritt ein Domänenfehler auf.

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

  • wenn das Argument kleiner als 1 ist, FE_INVALID wird ausgelöst und NaN wird zurückgegeben.
  • wenn das Argument 1 ist, wird +0 zurückgegeben.
  • wenn das Argument +∞ ist, wird +∞ zurückgegeben.
  • wenn das Argument NaN ist, wird NaN zurückgegeben.

Hinweise

Obwohl der C-Standard (auf den C++ für diese Funktion verweist) diese Funktion "Areakosinus Hyperbolicus" nennt, sind die Umkehrfunktionen der hyperbolischen Funktionen die Areafunktionen. Ihr Argument ist die Fläche eines hyperbolischen Sektors, nicht ein Bogen. Der korrekte Name ist "inverser hyperbolischer Kosinus" (von POSIX verwendet) oder "Areakosinus Hyperbolicus".

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 :: acosh ( num ) die gleiche Wirkung hat wie std :: acosh ( static_cast < double > ( num ) ) .

Beispiele

Diesen Code ausführen 
#include <cerrno>
#include <cfenv>
#include <cfloat>
#include <cmath>
#include <cstring>
#include <iostream>
// #pragma STDC FENV_ACCESS ON
int main()
{
    std::cout << "acosh(1) = " << std::acosh(1) << '\n'
              << "acosh(10) = " << std::acosh(10) << '\n'
              << "acosh(DBL_MAX) = " << std::acosh(DBL_MAX) << '\n'
              << "acosh(Inf) = " << std::acosh(INFINITY) << '\n';
    // Fehlerbehandlung
    errno = 0;
    std::feclearexcept(FE_ALL_EXCEPT);
    std::cout << "acosh(0.5) = " << std::acosh(0.5) << '\n';
    if (errno == EDOM)
        std::cout << "    errno == EDOM: " << std::strerror(errno) << '\n';
    if (std::fetestexcept(FE_INVALID))
        std::cout << "    FE_INVALID ausgelöst\n";
}

Mögliche Ausgabe: 

acosh(1) = 0
acosh(10) = 2.99322
acosh(DBL_MAX) = 710.476
acosh(Inf) = inf
acosh(0.5) = -nan
    errno == EDOM: Numerical argument out of domain
    FE_INVALID raised

Siehe auch

(C++11) (C++11) (C++11)
berechnet den Areasinus Hyperbolicus ( arsinh(x) )
(Funktion)
(C++11) (C++11) (C++11)
berechnet den Areatangens Hyperbolicus ( artanh(x) )
(Funktion)
(C++11) (C++11)
berechnet den Kosinus Hyperbolicus ( cosh(x) )
(Funktion)
(C++11)
berechnet den Areakosinus Hyperbolicus einer komplexen Zahl ( arcosh(z) )
(Funktionsschablone)
C-Dokumentation für acosh

Externe Links

Weisstein, Eric W. "Inverse Hyperbolic Cosine." Von MathWorld — Eine Wolfram Web Resource.