NAME
atanh, atanhf, atanhl - inverse hyperbolic tangent function
SYNOPSIS
#include <math.h>
double atanh(double x);
float atanhf(float x);
long double atanhl(long double x);
Link with -lm.
Feature Test Macro Requirements for glibc (see feature_test_macros(7)):
atanh():
_ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
|| _XOPEN_SOURCE >= 500
|| /* Since glibc 2.19: */ _DEFAULT_SOURCE
|| /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
atanhf(), atanhl():
_ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
|| /* Since glibc 2.19: */ _DEFAULT_SOURCE
|| /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
DESCRIPTION
These functions calculate the inverse hyperbolic tangent of x; that is the value whose hyperbolic tangent is x.
RETURN VALUE
On success, these functions return the inverse hyperbolic tangent of x. If x is a NaN, a NaN is returned. If x is +0 (-0), +0 (-0) is returned. If x is +1 or -1, a pole error occurs, and the functions return HUGE_VAL, HUGE_VALF, or HUGE_VALL, respectively, with the mathematically correct sign. If the absolute value of x is greater than 1, a domain error occurs, and a NaN is returned.
ERRORS
See math_error(7) for information on how to determine whether an error
has occurred when calling these functions.
The following errors can occur:
Domain error: x less than -1 or greater than +1
errno is set to EDOM. An invalid floating-point exception
(FE_INVALID) is raised.
Pole error: x is +1 or -1
errno is set to ERANGE (but see BUGS). A divide-by-zero
floating-point exception (FE_DIVBYZERO) is raised.
ATTRIBUTES
For an explanation of the terms used in this section, see attributes(7). Interface Attribute Value atanh(), atanhf(), atanhl() Thread safety MT-Safe
CONFORMING TO
C99, POSIX.1-2001, POSIX.1-2008. The variant returning double also conforms to SVr4, 4.3BSD, C89.
BUGS
In glibc 2.9 and earlier, when a pole error occurs, errno as set to EDOM instead of the POSIX-mandated ERANGE. Since version 2.10, glibc does the right thing.
SEE ALSO
acosh(3), asinh(3), catanh(3), cosh(3), sinh(3), tanh(3)
COLOPHON
This page is part of release 4.09 of the Linux man-pages project. A
description of the project, information about reporting bugs, and the
latest version of this page, can be found at
https://www.kernel.org/doc/man-pages/.
2016-03-15 ATANH(3)
More Linux Commands
manpages/timedatectl.1.html
timedatectl(1) Control the system time and date (Man Page)
timedatectl may be used to query and change the system clock and its settings. OPTIONS The following options are understood: --no-ask-password Do not query the
manpages/ppmglobe.1.html
ppmglobe(1) - generate strips to glue onto a sphere.........
This program is part of Netpbm(1) ppmglobe does the inverse of a cylindrical projection of a sphere. Starting with a cylindrical projection, it produces an imag
manpages/mmap.2.html
mmap(2) - map or unmap files or devices into memory.........
mmap() creates a new mapping in the virtual address space of the calling process. The starting address for the new mapping is specified in addr. The length argu
manpages/pam_fail_delay.3.html
pam_fail_delay(3) - request a delay on failure (Man Page)...
The pam_fail_delay function provides a mechanism by which an application or module can suggest a minimum delay of usec micro-seconds. The function keeps a recor
manpages/unget_wch.3ncurses.html
unget_wch(3ncurses) - get (or push back) a wide character fr
The get_wch, wget_wch, mvget_wch, and mvwget_wch functions read a character from the terminal associated with the current or specified window. In no-delay mode,
manpages/gzip.1.html
gzip(1) - compress or expand files - Linux manual page......
Gzip reduces the size of the named files using Lempel-Ziv coding (LZ77). Whenever possible, each file is replaced by one with the extension .gz, while keeping t
manpages/ilogbl.3.html
ilogbl(3) - get integer exponent of a floating-point value
These functions return the exponent part of their argument as a signed integer. When no error occurs, these functions are equivalent to the corresponding logb(3
manpages/config.guess.1.html
config.guess(1) - guess the build system triplet (Man Page)
The GNU build system distinguishes three types of machines, the build machine on which the compilers are run, the host machine on which the package being built
manpages/mvinchnstr.3ncurses.html
mvinchnstr(3ncurses) - get a string of characters (and attri
These routines return a NULL-terminated array of chtype quantities, starting at the current cursor position in the named window and ending at the right margin o
manpages/Tcl_DoOneEvent.3.html
Tcl_DoOneEvent(3) - wait for events and invoke event handler
This procedure is the entry point to Tcls event loop; it is responsible for waiting for events and dispatching event handlers created with procedures such as Tk
manpages/Tcl_ListObjIndex.3.html
Tcl_ListObjIndex(3) - manipulate Tcl objects as lists.......
Tcl list objects have an internal representation that supports the efficient indexing and appending. The procedures described in this man page are used to creat
manpages/Tcl_GetChannelOption.3.html
Tcl_GetChannelOption(3) - buffered I/O facilities using chan
The Tcl channel mechanism provides a device-independent and platform-independent mechanism for performing buffered input and output operations on a variety of f
