draft/man3/catanh.3

   1 .\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
   2 .\" and Copyright (C) 2011 Michael Kerrisk <mtk.manpages@gamil.com>
   3 .\" Distributed under GPL
   4 .\"
   5 .\"*******************************************************************
   6 .\"
   7 .\" This file was generated with po4a. Translate the source file.
   8 .\"
   9 .\"*******************************************************************
  10 .TH CATANH 3 2011\-09\-15 "" "Linux Programmer's Manual"
  11 .SH 名前
  12 catanh, catanhf, catanhl \- 複素数の逆双曲線正接 (arc tangents hyperbolic)
  13 .SH 書式
  14 \fB#include <complex.h>\fP
  15 .sp
  16 \fBdouble complex catanh(double complex \fP\fIz\fP\fB);\fP
  17 .br
  18 \fBfloat complex catanhf(float complex \fP\fIz\fP\fB);\fP
  19 .br
  20 \fBlong double complex catanhl(long double complex \fP\fIz\fP\fB);\fP
  21 .sp
  22 \fI\-lm\fP でリンクする。
  23 .SH 説明
  24 \fBcatanh\fP()  関数は複素数 \fIz\fP の逆双曲線正弦 (arc hyperbolic tangent) を計算する。 \fIy =
  25 catanh(z)\fP ならば、 \fIz = ctanh(y)\fP が成立する。 \fIy\fP の虚部の値は区間 [\-pi/2,pi/2] から選択される。
  26 .LP
  27 次の関係が成立する:
  28 .nf
  29
  30     catanh(z) = 0.5 * (clog(1 + z) \- clog(1 \- z))
  31 .fi
  32 .SH バージョン
  33 これらの関数は glibc バージョン 2.1 で初めて登場した。
  34 .SH 準拠
  35 C99.
  36 .SH 例
  37 .nf
  38 /* "\-lm" でリンクする */
  39
  40 #include <complex.h>
  41 #include <stdlib.h>
  42 #include <unistd.h>
  43 #include <stdio.h>
  44
  45 int
  46 main(int argc, char *argv[])
  47 {
  48     double complex z, c, f;
  49
  50     if (argc != 3) {
  51         fprintf(stderr, "Usage: %s <real> <imag>\en", argv[0]);
  52         exit(EXIT_FAILURE);
  53     }
  54
  55     z = atof(argv[1]) + atof(argv[2]) * I;
  56
  57     c = catanh(z);
  58     printf("catanh() = %6.3f %6.3f*i\en", creal(c), cimag(c));
  59
  60     f = 0.5 * (clog(1 + z) \- clog(1 \- z));
  61     printf("formula  = %6.3f %6.3f*i\en", creal(f2), cimag(f2));
  62
  63     exit(EXIT_SUCCESS);
  64 }
  65 .fi
  66 .SH 関連項目
  67 \fBatanh\fP(3), \fBcabs\fP(3), \fBcimag\fP(3), \fBctanh\fP(3), \fBcomplex\fP(7)