.\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
.\" and Copyright (C) 2011 Michael Kerrisk <mtk.manpages@gmail.com>
.\"
.\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
.\" Distributed under GPL
.\" %%%LICENSE_END
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.\"
.\" Japanese Version Copyright (c) 2003  Akihiro MOTOKI
.\"         all rights reserved.
.\" Translated Thu Jul 24 00:43:35 JST 2003
.\"         by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
.\"
.TH CATANH 3 2020\-06\-09 "" "Linux Programmer's Manual"
.SH 名前
catanh, catanhf, catanhl \- 複素数の逆双曲線正接 (arc tangents hyperbolic)
.SH 書式
\fB#include <complex.h>\fP
.PP
\fBdouble complex catanh(double complex \fP\fIz\fP\fB);\fP
.br
\fBfloat complex catanhf(float complex \fP\fIz\fP\fB);\fP
.br
\fBlong double complex catanhl(long double complex \fP\fIz\fP\fB);\fP
.PP
\fI\-lm\fP でリンクする。
.SH 説明
これらの関数は複素数 \fIz\fP の逆双曲線正弦 (arc hyperbolic tangent) を計算する。 \fIy = catanh(z)\fP
ならば、 \fIz = ctanh(y)\fP が成立する。 \fIy\fP の虚部の値は区間 [\-pi/2,pi/2] から選択される。
.PP
次の関係が成立する:
.PP
.nf
    catanh(z) = 0.5 * (clog(1 + z) \- clog(1 \- z))
.fi
.SH バージョン
これらの関数は glibc バージョン 2.1 で初めて登場した。
.SH 属性
この節で使用されている用語の説明については、 \fBattributes\fP(7) を参照。
.TS
allbox;
lbw30 lb lb
l l l.
インターフェース	属性	値
T{
\fBcatanh\fP(),
\fBcatanhf\fP(),
\fBcatanhl\fP()
T}	Thread safety	MT\-Safe
.TE
.SH 準拠
C99, POSIX.1\-2001, POSIX.1\-2008.
.SH 例
.EX
/* "\-lm" でリンクする */

#include <complex.h>
#include <stdlib.h>
#include <unistd.h>
#include <stdio.h>

int
main(int argc, char *argv[])
{
    double complex z, c, f;

    if (argc != 3) {
        fprintf(stderr, "Usage: %s <real> <imag>\en", argv[0]);
        exit(EXIT_FAILURE);
    }

    z = atof(argv[1]) + atof(argv[2]) * I;

    c = catanh(z);
    printf("catanh() = %6.3f %6.3f*i\en", creal(c), cimag(c));

    f = 0.5 * (clog(1 + z) \- clog(1 \- z));
    printf("formula  = %6.3f %6.3f*i\en", creal(f2), cimag(f2));

    exit(EXIT_SUCCESS);
}
.EE
.SH 関連項目
\fBatanh\fP(3), \fBcabs\fP(3), \fBcimag\fP(3), \fBctanh\fP(3), \fBcomplex\fP(7)
.SH この文書について
この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は
\%https://www.kernel.org/doc/man\-pages/ に書かれている。