acosh-acoshf-acoshl.md

title	ms.custom	ms.date	ms.reviewer	ms.suite	ms.technology	ms.tgt_pltfrm	ms.topic	apiname	apilocation	apitype	f1_keywords	dev_langs	helpviewer_keywords	ms.assetid	caps.latest.revision	author	ms.author	manager	ms.workload
acosh, acoshf, acoshl | Microsoft Docs		04/05/2018			cpp-standard-libraries		reference	acoshf acosh acoshl	msvcrt.dll msvcr80.dll msvcr90.dll msvcr100.dll msvcr100_clr0400.dll msvcr110.dll msvcr110_clr0400.dll msvcr120.dll msvcr120_clr0400.dll ucrtbase.dll api-ms-win-crt-math-l1-1-0.dll	DLLExport	acosh acoshf acoshl math/acosh math/acoshf math/acoshl	C++	acoshf function acosh function acoshl function	6985c4d7-9e2a-44ce-9a9b-5a43015f15f7	8	corob-msft	corob	ghogen	cplusplus

acosh, acoshf, acoshl

Calculates the inverse hyperbolic cosine.

Syntax

double acosh( double x );
float acoshf( float x );
long double acoshl( long double x );

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

Parameters

x
Floating-point value.

Return Value

The acosh functions return the inverse hyberbolic cosine (arc hyperbolic cosine) of x. These functions are valid over the domain x ≥ 1. If x is less than 1, errno is set to EDOM and the result is a quiet NaN. If x is a quiet NaN, indefinite, or infinity, the same value is returned.

Input	SEH Exception	_matherr Exception
± QNAN, IND, INF	none	none
x < 1	none	none

Remarks

When you use C++, you can call overloads of acosh that take and return float or long double values. In a C program, acosh always takes and returns double.

Requirements

Function	C header	C++ header
acosh, acoshf, acoshl	<math.h>	<cmath>

For additional compatibility information, see Compatibility.

Example

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

cosh( 0.785398 ) = 1.324609
acosh( 1.324609 ) = 0.785398

See also

Floating-Point Support
asinh, asinhf, asinhl
atanh, atanhf, atanhl
cosh, coshf, coshl
sinh, sinhf, sinhl
tanh, tanhf, tanhl