acosh, acoshf, acoshl

Calcula o cosseno hiperbólico inverso.

Sintaxe

double acosh( double x );
float acoshf( float x );
long double acoshl( long double x );
#define acosh(X) // Requires C11 or higher

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

Parâmetros

x
Valor de ponto flutuante.

Valor retornado

As acosh funções retornam o cosseno hiperbólico inverso (cosseno hiperbólico do arco) de x. Essas funções são válidas no domínio x ≥ 1. Se x for menor que 1, errno é definido como EDOM, e o resultado é um NaN silencioso. Se x for um NaN silencioso, indefinido ou de infinidade, será retornado o mesmo valor.

Entrada	Exceção SEH	Exceção _matherr
± QNaN, IND, INF	nenhum	nenhum
x< 1	nenhum	nenhum

Comentários

Ao usar C++, é possível chamar sobrecargas de acosh que usam e retornam os valores float ou long double. Em um programa C, a menos que você esteja usando a <macro tgmath.h> para chamar essa função, acosh sempre usa e retorna double.

Se você usa a macro <tgmath.h>acosh(), o tipo do argumento determina qual versão da função será selecionada. Confira Matemática do tipo genérico para obter detalhes.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.

Requisitos

Função	Cabeçalho C	Cabeçalho C++
acosh, acoshf, acoshl	<math.h>	<cmath>
Macro acosh	<tgmath.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

// 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

Confira também

Suporte matemático e de ponto flutuante
asinh, asinhf, asinhl
atanh, atanhf, atanhl
cosh, coshf, coshl
sinh, sinhf, sinhl
tanh, tanhf, tanhl