NOME

acos, acosf, acosl - função arco cosseno

BIBLIOTECA

Biblioteca matemática (libm, -lm)

SINOPSE

#include <math.h>

double acos(double x);
float acosf(float x);
long double acosl(long double x);

acosf(), acosl():

    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L


        || /* Desde o glibc 2.19: */ _DEFAULT_SOURCE


        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

DESCRIÇÃO

As funções calculam o arco cosseno de x, ou seja, o valor cujo cosseno é x.

VALOR DE RETORNO

No sucesso, estas funções retornam o arco cosseno de x em radianos; o valor de retorno está na faixa [0, pi].

Se x é um NaN, um NaN é retornado.

Se x é +1, +0 é retornado.

Se x é infinito positivo ou infinito negativo, ocorre um erro de domínio e um NaN é retornado.

Se x está fora da faixa [-1, 1], ocorre um erro de domínio e um NaN é retornado.

ERROS

Consulte math_error(7) para obter informações sobre como determinar se ocorreu um erro ao chamar essas funções.

Os seguintes erros podem ocorrer:

Domain error: x is outside the range [-1, 1]

errno é definido com EDOM. Uma exceção de ponto flutuante inválida (FE_INVALID) é levantada.

ATRIBUTOS

Para uma explicação dos termos usados nesta seção, consulte attributes(7).

PADRÕES

C99, POSIX.1-2001, POSIX.1-2008.

A variante retornando double também está em conformidade com SVr4, 4.3BSD.

VEJA TAMBÉM

asin(3), atan(3), atan2(3), cacos(3), cos(3), sin(3), tan(3)

TRADUÇÃO

A tradução para português brasileiro desta página man foi criada por Paulo César Mendes <drpc@ism.com.br>, André Luiz Fassone <lonely_wolf@ig.com.br> e Rafael Fontenelle <rafaelff@gnome.org>.

Esta tradução é uma documentação livre; leia a Licença Pública Geral GNU Versão 3 ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita.

Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para a lista de discussão de tradutores.