Namensräume
Varianten
Aktionen

acosh, acoshf, acoshl

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)
(C99)
acosh
(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       acoshf( float arg );
(1) (seit C99)
double      acosh( double arg );
(2) (seit C99)
long double acoshl( long double arg );
(3) (seit C99)
Definiert in Header <tgmath.h>
#define acosh( arg )
(4) (seit C99)
1-3) Berechnet den inversen hyperbolischen Kosinus von arg.
4) Typ-generische Makro: Wenn das Argument vom Typ long double ist, wird acoshl aufgerufen. Andernfalls, wenn das Argument einen Ganzzahltyp oder den Typ double hat, wird acosh aufgerufen. Andernfalls wird acoshf aufgerufen. Wenn das Argument komplex ist, ruft das Makro die entsprechende komplexe Funktion auf (cacoshf, cacosh, cacoshl).

Inhalt

[edit] Parameter

arg - Gleitkommazahl, die die Fläche eines hyperbolischen Sektors darstellt

[edit] Rückgabewert

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

Wenn ein Domänenfehler auftritt, wird ein implementierungsabhängiger Wert zurückgegeben (NaN, wo unterstützt).

[edit] Fehlerbehandlung

Fehler werden wie in math_errhandling angegeben gemeldet.

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

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

  • Wenn das Argument kleiner als 1 ist, wird FE_INVALID ausgelöst und NaN 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.

[edit] Anmerkungen

Obwohl der C-Standard diese Funktion "arcus hyperbolischer Kosinus" nennt, sind die inversen Funktionen der hyperbolischen Funktionen die Areafunktionen. Ihr Argument ist die Fläche eines hyperbolischen Sektors, nicht eines Bogens. Der korrekte Name ist "inverser hyperbolischer Kosinus" (verwendet von POSIX) oder "Area-hyperbolischer Kosinus".

[edit] Beispiel

#include <errno.h>
#include <fenv.h>
#include <float.h>
#include <math.h>
#include <stdio.h>
// #pragma STDC FENV_ACCESS ON
 
int main(void)
{
    printf("acosh(1) = %f\nacosh(10) = %f\n", acosh(1), acosh(10));
    printf("acosh(DBL_MAX) = %f\nacosh(Inf) = %f\n", acosh(DBL_MAX), acosh(INFINITY));
 
    // error handling
    errno = 0; feclearexcept(FE_ALL_EXCEPT);
    printf("acosh(0.5) = %f\n", acosh(0.5));
    if (errno == EDOM)
        perror("    errno == EDOM");
    if (fetestexcept(FE_INVALID))
        puts("    FE_INVALID raised");
}

Mögliche Ausgabe

acosh(1) = 0.000000
acosh(10) = 2.993223
acosh(DBL_MAX) = 710.475860
acosh(Inf) = inf
acosh(0.5) = -nan
    errno == EDOM: Numerical argument out of domain
    FE_INVALID raised

[edit] Referenzen

  • C23-Standard (ISO/IEC 9899:2024)
  • 7.12.5.1 Die acosh-Funktionen (S. TBD)
  • 7.27 Typ-generische Mathematik <tgmath.h> (S. TBD)
  • F.10.2.1 Die acosh-Funktionen (S. TBD)
  • C17-Standard (ISO/IEC 9899:2018)
  • 7.12.5.1 Die acosh-Funktionen (S. 175)
  • 7.25 Typ-generische Mathematik <tgmath.h> (S. 272-273)
  • F.10.2.1 Die acosh-Funktionen (S. 379)
  • C11-Standard (ISO/IEC 9899:2011)
  • 7.12.5.1 Die acosh-Funktionen (S. 240)
  • 7.25 Typ-generische Mathematik <tgmath.h> (S. 373-375)
  • F.10.2.1 Die acosh-Funktionen (S. 520)
  • C99-Standard (ISO/IEC 9899:1999)
  • 7.12.5.1 Die acosh-Funktionen (S. 221)
  • 7.22 Typ-generische Mathematik <tgmath.h> (S. 335-337)
  • F.9.2.1 Die acosh-Funktionen (S. 457)

[edit] Siehe auch

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

[edit] Externe Links

Weisstein, Eric W. "Inverse Hyperbolic Cosine." Von MathWorld – Eine Ressource von Wolfram Web.