draft/man3/sincos.3

   1 .\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
   2 .\" Distributed under GPL, 2002-07-27 Walter Harms
   3 .\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk
   4 .\"     <mtk.manpages@gmail.com>
   5 .\"
   6 .\" Japanese Version Copyright (c) 2003  Akihiro MOTOKI
   7 .\"         all rights reserved.
   8 .\" Translated Tue Sep  9 04:06:20 JST 2003
   9 .\"         by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  10 .\" Updated 2008-09-16, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  11 .\"
  12 .TH SINCOS 3  2008-08-11 "GNU" "Linux Programmer's Manual"
  13 .\"O .SH NAME
  14 .SH Ì¾Á°
  15 .\"O sincos, sincosf, sincosl \- calculate sin and cos simultaneously
  16 sincos, sincosf, sincosl \- Àµ¸¹¤ÈÍ¾¸¹¤òÆ±»þ¤Ë·×»»¤¹¤ë
  17 .\"O .SH SYNOPSIS
  18 .SH ½ñ¼°
  19 .nf
  20 .\"O .BR "#define _GNU_SOURCE" "         /* See feature_test_macros(7) */"
  21 .BR "#define _GNU_SOURCE" "         /* feature_test_macros(7) »²¾È */"
  22 .B #include <math.h>
  23 .sp
  24 .BI "void sincos(double " x ", double *" sin ", double *" cos );
  25 .br
  26 .BI "void sincosf(float " x ", float *" sin ", float *" cos );
  27 .br
  28 .BI "void sincosl(long double " x ", long double *" sin ", long double *" cos );
  29 .fi
  30 .sp
  31 .\"O Link with \fI\-lm\fP.
  32 \fI\-lm\fP ¤Ç¥ê¥ó¥¯¤¹¤ë¡£
  33 .\"O .SH DESCRIPTION
  34 .SH ÀâÌÀ
  35 .\"O Several applications need sine and cosine of the same angle
  36 .\"O .IR x .
  37 .\"O This function computes both at the same time, and stores the results in
  38 .\"O .I *sin
  39 .\"O and
  40 .\"O .IR *cos .
  41 ¥¢¥×¥ê¥±¡¼¥·¥ç¥ó¤ÎÃæ¤Ë¤Ï¡¢Æ±¤¸³ÑÅÙ
  42 .I x
  43 ¤Ë¤Ä¤¤¤ÆÀµ¸¹¤ÈÍ¾¸¹¤ÎÎ¾Êý¤Î·×»»¤¬É¬Í×¤Ê¤â¤Î¤¬¤¢¤ë¡£
  44 ¤³¤Î´Ø¿ô¤ÏÎ¾¼Ô¤òÆ±»þ¤Ë·×»»¤·¡¢¤½¤Î·ë²Ì¤ò
  45 .I *sin
  46 ¤È
  47 .I *cos
  48 ¤Ë³ÊÇ¼¤¹¤ë¡£
  49
  50 .\"O If
  51 .\"O .I x
  52 .\"O is a NaN,
  53 .\"O a NaN is returned in
  54 .\"O .I *sin
  55 .\"O and
  56 .\"O .IR *cos .
  57 .I x
  58 ¤¬ NaN ¤Î¾ì¹ç¡¢
  59 .I *sin
  60 ¤È
  61 .I *cos
  62 ¤Ë NaN ¤¬ÊÖ¤µ¤ì¤ë¡£
  63
  64 .\"O If
  65 .\"O .I x
  66 .\"O is positive infinity or negative infinity,
  67 .\"O a domain error occurs, and
  68 .\"O a NaN is returned in
  69 .\"O .I *sin
  70 .\"O and
  71 .\"O .IR *cos .
  72 .I x
  73 ¤¬Àµ¤ÎÌµ¸ÂÂç¤«Éé¤ÎÌµ¸ÂÂç¤Î¾ì¹ç¡¢
  74 ÎÎ°è¥¨¥é¡¼ (domain error) ¤¬È¯À¸¤·¡¢
  75 .I *sin
  76 ¤È
  77 .I *cos
  78 ¤Ë NaN ¤¬ÊÖ¤µ¤ì¤ë¡£
  79 .\"O .SH RETURN VALUE
  80 .SH ÊÖ¤êÃÍ
  81 .\"O These functions return
  82 .\"O .IR void .
  83 ¤³¤ì¤é¤Î´Ø¿ô¤Ï
  84 .I void
  85 ¤òÊÖ¤¹¡£
  86 .\"O .SH ERRORS
  87 .SH ¥¨¥é¡¼
  88 .\"O See
  89 .\"O .BR math_error (7)
  90 .\"O for information on how to determine whether an error has occurred
  91 .\"O when calling these functions.
  92 ¤³¤ì¤é¤Î´Ø¿ô¤ò¸Æ¤Ó½Ð¤·¤¿ºÝ¤Ë¥¨¥é¡¼¤¬È¯À¸¤·¤¿¤«¤ÎÈ½ÄêÊýË¡¤Ë¤Ä¤¤¤Æ¤Î¾ðÊó¤Ï
  93 .BR math_error (7)
  94 ¤ò»²¾È¤Î¤³¤È¡£
  95 .PP
  96 .\"O The following errors can occur:
  97 °Ê²¼¤Î¥¨¥é¡¼¤¬È¯À¸¤¹¤ë²ÄÇ½À¤¬¤¢¤ë¡£
  98 .TP
  99 .\"O Domain error: \fIx\fP is an infinity
 100 ÎÎ°è¥¨¥é¡¼ (domain error): \fIx\fp ¤¬Ìµ¸ÂÂç
 101 .\" .I errno
 102 .\" is set to
 103 .\" .BR EDOM .
 104 .\"O An invalid floating-point exception
 105 .\"O .RB ( FE_INVALID )
 106 .\"O is raised.
 107 ÉÔÀµ (invalid) ÉâÆ°¾®¿ôÅÀÎã³°
 108 .RB ( FE_INVALID )
 109 ¤¬¾å¤¬¤ë¡£
 110 .PP
 111 .\"O These functions do not set
 112 .\"O .IR errno .
 113 ¤³¤ì¤é¤Î´Ø¿ô¤Ï
 114 .I errno
 115 ¤òÀßÄê¤·¤Ê¤¤¡£
 116 .\" FIXME . Is it intentional that these functions do not set errno?
 117 .\" sin() and cos() also don't set errno; bugs have been raised for
 118 .\" those functions.
 119 .\"O .SH VERSIONS
 120 .SH ¥Ð¡¼¥¸¥ç¥ó
 121 .\"O These functions first appeared in glibc in version 2.1.
 122 ¤³¤ì¤é¤Î´Ø¿ô¤Ï glibc ¥Ð¡¼¥¸¥ç¥ó 2.1 ¤Ç½é¤á¤ÆÅÐ¾ì¤·¤¿¡£
 123 .\"O .SH "CONFORMING TO"
 124 .SH ½àµò
 125 .\"O This function is a GNU extension.
 126 ¤³¤Î´Ø¿ô¤Ï GNU ¤Ë¤è¤ë³ÈÄ¥¤Ç¤¢¤ë¡£
 127 .\"O .SH "SEE ALSO"
 128 .SH ´ØÏ¢¹àÌÜ
 129 .BR cos (3),
 130 .BR sin (3),
 131 .BR tan (3)