acosh, acoshf, acoshl

Parameter

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 implementierungsdefinierter Wert zurückgegeben (NaN, falls 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 diese Funktion als "Areakosinus Hyperbolicus" bezeichnet, sind die Umkehrfunktionen der hyperbolischen Funktionen die Areafunktionen. Ihr Argument ist die Fläche eines hyperbolischen Sektors, kein Bogen. Der korrekte Name ist "inverse hyperbolische Kosinusfunktion" (von POSIX verwendet) oder "Areakosinus Hyperbolicus".

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");
}

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

Referenzen

Siehe auch

Externe Links