WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

acosh — inverser hyperbolischer Kosinus

Die Funktion acosh aus <math.h> berechnet den nichtnegativen inversen hyperbolischen Kosinus. Sie nimmt einen double-Wert entgegen und gibt einen double-Wert zurück; ein Argument kleiner als 1 verursacht einen Definitionsbereichsfehler.

Version: C23; repository compiler flag, production runtime not attested

Syntax

#include <math.h>
double acosh(double x);

acosh(x) bestimmt den nichtnegativen Wert y, für den mathematisch cosh(y) = x gilt. Die Funktion ist nicht der Kehrwert 1 / cosh(x). Ihre Deklaration in <math.h> nimmt einen Wert vom Typ double entgegen und gibt einen solchen zurück.

Der reelle Definitionsbereich ist x >= 1; das Ergebnis liegt in [0, +∞]. Für x < 1 tritt ein Definitionsbereichsfehler auf. Gehen Sie nicht davon aus, dass dieser Aufruf portabel ein bestimmtes Ergebnis liefert.

Bei IEC-60559-Unterstützung gemäß Anhang F gibt acosh(1) +0 und acosh(+∞) +∞ zurück. Für x < 1 wird NaN zurückgegeben und die Ausnahme invalid ausgelöst.

Beispiele

#include <math.h>
#include <stdio.h>

int main(void)
{
    double x = 1.0;
    double y = acosh(x);
    printf("acosh(1) == 0: %d\n", y == 0.0);
    return 0;
}

Ergebnis

acosh(1) == 0: 1

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen