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 .\" Japanese Version Copyright (c) 2003  Akihiro MOTOKI
   6 .\"         all rights reserved.
   7 .\" Translated Thu Jul 24 00:43:35 JST 2003
   8 .\"         by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
   9 .\"
  10 .\"WORD:        hyperbolic      双曲(線の)
  11 .\"WORD:        arc sine        逆正弦
  12 .\"WORD:        arc cosine      逆余弦
  13 .\"WORD:        arc tangent     逆正接
  14 .\"WORD:        real part       実部
  15 .\"WORD:        imaginary part  虚部
  16 .\"
  17 .TH CATANH 3 2011-09-15 "" "Linux Programmer's Manual"
  18 .\"O .SH NAME
  19 .SH 名前
  20 .\"O catanh, catanhf, catanhl \- complex arc tangents hyperbolic
  21 catanh, catanhf, catanhl \- 複素数の逆双曲線正接 (arc tangents hyperbolic)
  22 .\"O .SH SYNOPSIS
  23 .SH 書式
  24 .B #include <complex.h>
  25 .sp
  26 .BI "double complex catanh(double complex " z );
  27 .br
  28 .BI "float complex catanhf(float complex " z );
  29 .br
  30 .BI "long double complex catanhl(long double complex " z );
  31 .sp
  32 .\"O Link with \fI\-lm\fP.
  33 \fI\-lm\fP でリンクする。
  34 .\"O .SH DESCRIPTION
  35 .SH 説明
  36 .\"O The
  37 .\"O .BR catanh ()
  38 .\"O function calculates the complex arc hyperbolic tangent of
  39 .\"O .IR z .
  40 .\"O If \fIy\ =\ catanh(z)\fP, then \fIz\ =\ ctanh(y)\fP.
  41 .\"O The imaginary part of
  42 .\"O .I y
  43 .\"O is chosen in the interval [\-pi/2,pi/2].
  44 .BR catanh ()
  45 関数は複素数
  46 .I z
  47 の逆双曲線正弦 (arc hyperbolic tangent) を計算する。
  48 \fIy = catanh(z)\fP ならば、 \fIz = ctanh(y)\fP が成立する。
  49 .I y
  50 の虚部の値は区間 [\-pi/2,pi/2] から選択される。
  51 .LP
  52 .\"O One has:
  53 次の関係が成立する:
  54 .nf
  55
  56     catanh(z) = 0.5 * (clog(1 + z) \- clog(1 \- z))
  57 .fi
  58 .\"O .SH VERSIONS
  59 .SH バージョン
  60 .\"O These functions first appeared in glibc in version 2.1.
  61 これらの関数は glibc バージョン 2.1 で初めて登場した。
  62 .\"O .SH "CONFORMING TO"
  63 .SH 準拠
  64 C99.
  65 .\"O .SH EXAMPLE
  66 .SH 例
  67 .nf
  68 /* Link with "\-lm" */
  69
  70 #include <complex.h>
  71 #include <stdlib.h>
  72 #include <unistd.h>
  73 #include <stdio.h>
  74
  75 int
  76 main(int argc, char *argv[])
  77 {
  78     double complex z, c, f;
  79
  80     if (argc != 3) {
  81         fprintf(stderr, "Usage: %s <real> <imag>\\n", argv[0]);
  82         exit(EXIT_FAILURE);
  83     }
  84
  85     z = atof(argv[1]) + atof(argv[2]) * I;
  86
  87     c = catanh(z);
  88     printf("catanh() = %6.3f %6.3f*i\\n", creal(c), cimag(c));
  89
  90     f = 0.5 * (clog(1 + z) \- clog(1 \- z));
  91     printf("formula  = %6.3f %6.3f*i\\n", creal(f2), cimag(f2));
  92
  93     exit(EXIT_SUCCESS);
  94 }
  95 .fi
  96 .\"O .SH "SEE ALSO"
  97 .SH 関連項目
  98 .BR atanh (3),
  99 .BR cabs (3),
 100 .BR cimag (3),
 101 .BR ctanh (3),
 102 .BR complex (7)