draft/man3/cacosh.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:26:52 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 CACOSH 3 2011-09-15 "" "Linux Programmer's Manual"
  18 .\"O .SH NAME
  19 .SH 名前
  20 .\"O cacosh, cacoshf, cacoshl \- complex arc hyperbolic cosine
  21 cacosh, cacoshf, cacoshl \- 複素数の逆双曲線余弦 (arc hyperbolic cosine)
  22 .\"O .SH SYNOPSIS
  23 .SH 書式
  24 .B #include <complex.h>
  25 .sp
  26 .BI "double complex cacosh(double complex " z );
  27 .br
  28 .BI "float complex cacoshf(float complex " z );
  29 .br
  30 .BI "long double complex cacoshl(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 cacosh ()
  38 .\"O function calculates the complex arc hyperpolic cosine of
  39 .\"O .IR z .
  40 .\"O If \fIy\ =\ cacosh(z)\fP, then \fIz\ =\ ccosh(y)\fP.
  41 .\"O The imaginary part of
  42 .\"O .I y
  43 .\"O is chosen in the interval [\-pi,pi].
  44 .\"O The real part of
  45 .\"O .I y
  46 .\"O is chosen nonnegative.
  47 .BR cacosh ()
  48 関数は複素数
  49 .I z
  50 の逆双曲線余弦 (arc hyperbolic cosine) を計算する。
  51 \fIy\ =\ cacosh(z)\fP ならば、
  52 \fIz\ =\ ccosh(y)\fP が成立する。
  53 .I y
  54 の虚部の値は区間 [\-pi,pi] から選択され、
  55 .I y
  56 の実部の値は非負の値が選択される。
  57 .LP
  58 .\"O One has:
  59 次の関係が成立する:
  60 .nf
  61
  62     cacosh(z) = 2 * clog(csqrt((z + 1) / 2) + csqrt((z \- 1) / 2))
  63 .fi
  64 .\"O .SH VERSIONS
  65 .SH バージョン
  66 .\"O These functions first appeared in glibc in version 2.1.
  67 これらの関数は glibc バージョン 2.1 で初めて登場した。
  68 .\"O .SH "CONFORMING TO"
  69 .SH 準拠
  70 C99.
  71 .\"O .SH EXAMPLE
  72 .SH 例
  73 .nf
  74 /* Link with "\-lm" */
  75
  76 #include <complex.h>
  77 #include <stdlib.h>
  78 #include <unistd.h>
  79 #include <stdio.h>
  80
  81 int
  82 main(int argc, char *argv[])
  83 {
  84     double complex z, c, f;
  85
  86     if (argc != 3) {
  87         fprintf(stderr, "Usage: %s <real> <imag>\\n", argv[0]);
  88         exit(EXIT_FAILURE);
  89     }
  90
  91     z = atof(argv[1]) + atof(argv[2]) * I;
  92
  93     c = cacosh(z);
  94     printf("cacosh() = %6.3f %6.3f*i\\n", creal(c), cimag(c));
  95
  96     f = 2 * clog(csqrt((z + 1)/2) + csqrt((z \- 1)/2));
  97     printf("formula  = %6.3f %6.3f*i\\n", creal(f2), cimag(f2));
  98
  99     exit(EXIT_SUCCESS);
 100 }
 101 .fi
 102 .\"O .SH "SEE ALSO"
 103 .SH 関連項目
 104 .BR acosh (3),
 105 .BR cabs (3),
 106 .BR ccosh (3),
 107 .BR cimag (3),
 108 .BR complex (7)