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)