.\" -*- 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-27 by Walter Harms
.\" 	(walter.harms@informatik.uni-oldenburg.de)
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH atanh 3 "20 июля 2023 г." "Linux man\-pages 6.05.01" 
.SH ИМЯ
atanh, atanhf, atanhl \- вычисление функции обратного гиперболического
тангенса
.SH LIBRARY
Math library (\fIlibm\fP, \fI\-lm\fP)
.SH СИНТАКСИС
.nf
\fB#include <math.h>\fP
.PP
\fBdouble atanh(double \fP\fIx\fP\fB);\fP
\fBfloat atanhf(float \fP\fIx\fP\fB);\fP
\fBlong double atanhl(long double \fP\fIx\fP\fB);\fP
.PP
.fi
.RS -4
Требования макроса тестирования свойств для glibc
(см. \fBfeature_test_macros\fP(7)):
.RE
.PP
\fBatanh\fP():
.nf
.\"    || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || _XOPEN_SOURCE >= 500
        || /* начиная с glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
.fi
.PP
\fBatanhf\fP(), \fBatanhl\fP():
.nf
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || /* начиная с glibc 2.19: */ _DEFAULT_SOURCE
        || /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
.fi
.SH ОПИСАНИЕ
Эти функции вычисляют обратный гиперболический тангенс значения \fIx\fP;
гиперболический тангенс результата будет равен \fIx\fP.
.SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ"
При успешном выполнении данные функции возвращают обратный гиперболический
тангенс от \fIx\fP.
.PP
Если \fIx\fP имеет значение NaN, будет возвращено NaN.
.PP
Если \fIx\fP равно +0 (\-0), будет возвращено +0 (\-0).
.PP
Если \fIx\fP равно +1 или \-1, то возникает ошибка особой точки, а функции
возвращают \fBHUGE_VAL\fP, \fBHUGE_VALF\fP или \fBHUGE_VALL\fP, соответственно, с
математически правильным знаком.
.PP
.\"
.\" POSIX.1-2001 documents an optional range error for subnormal x;
.\" glibc 2.8 does not do this.
Если абсолютное значение \fIx\fP больше 1, то будет сгенерирована ошибка выхода
за пределы области, а в качестве результата будет возвращено NaN.
.SH ОШИБКИ
Смотрите \fBmath_error\fP(7), чтобы определить, какие ошибки могут возникать
при вызове этих функций.
.PP
Могут возникать следующие ошибки:
.TP 
Ошибка области: \fIx\fP меньше \-1 или больше +1
\fIerrno\fP устанавливается в \fBEDOM\fP. Вызывается исключение неправильной
плавающей точки (\fBFE_INVALID\fP).
.TP 
Ошибка особой точки: \fIx\fP равно +1 или \-1
\fIerrno\fP устанавливается в \fBERANGE\fP (но смотрите ДЕФЕКТЫ). Возникает
исключение деления плавающей запятой на ноль (\fBFE_DIVBYZERO\fP).
.SH АТРИБУТЫ
Описание терминов данного раздела смотрите в \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Интерфейс	Атрибут	Значение
T{
.na
.nh
\fBatanh\fP(),
\fBatanhf\fP(),
\fBatanhl\fP()
T}	Безвредность в нитях	MT\-Safe
.TE
.sp 1
.SH СТАНДАРТЫ
C11, POSIX.1\-2008.
.SH ИСТОРИЯ
C99, POSIX.1\-2001.
.PP
Вариант, возвращающий значение типа \fIdouble\fP, также соответствует SVr4,
4.3BSD.
.SH ДЕФЕКТЫ
.\" Bug: https://www.sourceware.org/bugzilla/show_bug.cgi?id=6759
.\" This can be seen in sysdeps/ieee754/k_standard.c
In glibc 2.9 and earlier, when a pole error occurs, \fIerrno\fP is set to
\fBEDOM\fP instead of the POSIX\-mandated \fBERANGE\fP.  Since glibc 2.10, glibc
does the right thing.
.SH "СМ. ТАКЖЕ"
\fBacosh\fP(3), \fBasinh\fP(3), \fBcatanh\fP(3), \fBcosh\fP(3), \fBsinh\fP(3), \fBtanh\fP(3)
.PP
.SH ПЕРЕВОД
Русский перевод этой страницы руководства был сделан
Dmitry Bolkhovskikh <d20052005@yandex.ru>
и
Yuri Kozlov <yuray@komyakino.ru>
.
.PP
Этот перевод является бесплатной документацией; прочитайте
.UR https://www.gnu.org/licenses/gpl-3.0.html
Стандартную общественную лицензию GNU версии 3
.UE
или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.
.PP
Если вы обнаружите ошибки в переводе этой страницы руководства,
пожалуйста, отправьте электронное письмо на
.MT man-pages-ru-talks@lists.sourceforge.net
.ME .