.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
.\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk
.\"     <mtk.manpages@gmail.com>
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\" References consulted:
.\"     Linux libc source code
.\"     Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
.\"     386BSD man pages
.\" Modified 1993-07-24 by Rik Faith (faith@cs.unc.edu)
.\" Modified 2002-07-25 by Walter Harms
.\" 	(walter.harms@informatik.uni-oldenburg.de)
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH asin 3 "2 maio 2024" "Linux man\-pages 6.8" 
.SH NOME
asin, asinf, asinl \- função arco seno
.SH BIBLIOTECA
Biblioteca matemática (\fIlibm\fP, \fI\-lm\fP)
.SH SINOPSE
.nf
\fB#include <math.h>\fP
.P
\fBdouble asin(double \fP\fIx\fP\fB);\fP
\fBfloat asinf(float \fP\fIx\fP\fB);\fP
\fBlong double asinl(long double \fP\fIx\fP\fB);\fP
.fi
.P
.RS -4
Requisitos de macro de teste de recursos para o glibc (consulte
\fBfeature_test_macros\fP(7)):
.RE
.P
\fBasinf\fP(), \fBasinl\fP():
.nf
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || /* Desde o glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
.fi
.SH DESCRIÇÃO
Estas funções calculam o valor principal do arco seno de \fIx\fP, ou seja, o
valor cujo seno é \fIx\fP.
.SH "VALOR DE RETORNO"
No caso de sucesso, estas funções retornam o valor principal do arco seno de
\fIx\fP em radianos; o valor retornado está na faixa [\-pi/2,\ pi/2].
.P
Se \fIx\fP é um NaN, um NaN é retornado.
.P
Se \fIx\fP é +0 (\-0), +0 (\-0) é retornado.
.P
.\"
.\" POSIX.1-2001 documents an optional range error for subnormal x;
.\" glibc 2.8 does not do this.
Se \fIx\fP está fora da faixa [\-1,\ 1], ocorre um erro de domínio e um NaN é
retornado.
.SH ERROS
Consulte \fBmath_error\fP(7) para obter informações sobre como determinar se
ocorreu um erro ao chamar essas funções.
.P
Os seguintes erros podem ocorrer:
.TP 
Domain error: \fIx\fP is outside the range [\-1,\ 1]
\fIerrno\fP é definido com \fBEDOM\fP. Uma exceção de ponto flutuante inválida
(\fBFE_INVALID\fP) é levantada.
.SH ATRIBUTOS
Para uma explicação dos termos usados nesta seção, consulte
\fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Interface	Atributo	Valor
T{
.na
.nh
\fBasin\fP(),
\fBasinf\fP(),
\fBasinl\fP()
T}	Thread safety	MT\-Safe
.TE
.SH PADRÕES
C11, POSIX.1\-2008.
.SH HISTÓRICO
C99, POSIX.1\-2001.
.P
A variante retornando \fIdouble\fP também está de acordo com SVr4, 4.3BSD, C89.
.SH "VEJA TAMBÉM"
\fBacos\fP(3), \fBatan\fP(3), \fBatan2\fP(3), \fBcasin\fP(3), \fBcos\fP(3), \fBsin\fP(3),
\fBtan\fP(3)
.PP
.SH 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>.
.
.PP
Esta tradução é uma documentação livre; leia a
.UR https://www.gnu.org/licenses/gpl-3.0.html
Licença Pública Geral GNU Versão 3 
.UE
ou posterior para as condições de direitos autorais.
Nenhuma responsabilidade é aceita.
.PP
Se você encontrar algum erro na tradução desta página de manual,
envie um e-mail para
.MT debian-l10n-portuguese@lists.debian.org
a lista de discussão de tradutores
.ME .