acos, acosf, acosl

Calcula o arco cosseno.

Sintaxe

double acos( double x );
float acosf( float x );
long double acosl( long double x );
#define acos(X) // Requires C11 or higher

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

Parâmetros

x
Valor entre -1 e 1, usado para calcular o arco cosseno (o cosseno inverso).

Valor retornado

A função acos retorna o arco cosseno de x no intervalo de 0 a π radianos.

Por padrão, se x for menor que -1 ou maior que 1, acos retornará um indefinido.

Entrada Exceção SEH Exceção _matherr
± INF INVALID _DOMAIN
± QNaN, IND nenhum _DOMAIN
|x| > 1 INVALID _DOMAIN

Comentários

Como C++ permite sobrecargas, é possível chamar sobrecargas de acos que usam e retornam tipos float e long double. Em um programa do C, a menos que você esteja usando a macro <tgmath.h> para chamar essa função, acos sempre recebe e retorna um double.

Se você usar a acos macro de <tgmath.h>, o tipo do argumento determinará 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

Rotina Cabeçalho necessário Cabeçalhos opcionais
acos, acosf, acosl <math.h> <errno.h>
Macro acos <tgmath.h>

Exemplo

Este programa solicita um valor no intervalo de –1 a 1. Valores de entrada fora desse intervalo produzem mensagens de erro de _DOMAIN. Se um valor válido for inserido, o programa imprimirá o arco seno e o arco cosseno desse valor.

// crt_asincos.c
// arguments: 0

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

int main( int ac, char* av[] )
{
    double  x,
            y;
    errno_t err;

    // argument checking
    if (ac != 2)
    {
        fprintf_s( stderr, "Usage: %s <number between -1 and 1>\n",
                   av[0]);
        return 1;
    }

    // Convert argument into a double value
    if ((err = sscanf_s( av[1], "%lf", &x )) != 1)
    {
        fprintf_s( stderr, "Error converting argument into ",
                   "double value.\n");
        return 1;
    }

    // Arcsine of X
    y = asin( x );
    printf_s( "Arcsine of %f = %f\n", x, y );

    // Arccosine of X
    y = acos( x );
    printf_s( "Arccosine of %f = %f\n", x, y );
}
Arcsine of 0.000000 = 0.000000
Arccosine of 0.000000 = 1.570796

Confira também

Suporte matemático e de ponto flutuante
asin, asinf, asinl
atan, atanf, atanl, atan2, atan2f, , atan2l
cos, cosf, cosl
_matherr
sin, sinf, sinl
tan, tanf, tanl