acosh, acoshf, acoshl

Artikel
06/09/2015

Berechnet den umgekehrten hyperbolischen Cosinus.

double acosh(    double x  ); float acosh(    float x  );  // C++ only long double acosh(    long double x );  // C++ only float acoshf(    float x  ); long double acoshl(    long double x );

Parameter

x
Gleitkommawert.

Rückgabewert

Die acosh-Funktionen geben den umgekehrten hyperbolischen Cosinus (hyperbolischen Arcuscosinus) von x zurück. Diese Funktionen sind in der Domäne x ≥ 1 gültig. Wenn x kleiner als 1 ist, wird errno auf EDOM gesetzt, und das Ergebnis ist ein stilles NaN. Wenn x ein stilles NaN, undefiniert oder unendlich ist, wird derselbe Wert zurückgegeben.

Eingabe	SEH-Ausnahme	_matherr-Ausnahme
± QNAN, IND, INF	Keine	Keine
x < 1	Keine	Keine

Hinweise

Wenn Sie C++ verwenden, können Sie Überladungen von acosh aufrufen, die float oder long double-Werte verwenden und zurückgeben. In einem C-Programm verwendet acosh immer double und gibt diesen Wert zurück.

Anforderungen

Funktion	C-Header	C++-Header
acosh, acoshf, acoshl	<math.h>	<cmath>

Zusätzliche Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Beispiel

// crt_acosh.c
// Compile by using: cl /W4 crt_acosh.c
// This program displays the hyperbolic cosine of pi / 4
// and the arc hyperbolic cosine of the result.

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

int main( void )
{
   double pi = 3.1415926535;
   double x, y;

   x = cosh( pi / 4 );
   y = acosh( x );
   printf( "cosh( %f ) = %f\n", pi/4, x );
   printf( "acosh( %f ) = %f\n", x, y );
}