OSDN Git Service

Update drafts for LDP 3.67
[linuxjm/LDP_man-pages.git] / draft / man3 / sin.3
index 1f48bf7..bcb6c48 100644 (file)
@@ -2,6 +2,7 @@
 .\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk
 .\"     <mtk.manpages@gmail.com>
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
@@ -21,6 +22,7 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
 .\" References consulted:
 .\"     Linux libc source code
 .\"     386BSD man pages
 .\" Modified 1993-07-24 by Rik Faith (faith@cs.unc.edu)
 .\" Modified 2002-07-27 by Walter Harms
-.\"    (walter.harms@informatik.uni-oldenburg.de)
+.\"    (walter.harms@informatik.uni-oldenburg.de)
+.\"
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
 .\"
 .\" Japanese Version Copyright (c) 1996 Kenji Kajiwara and Kentaro Ogawa
 .\"         all rights reserved.
 .\"         by Yuichi SATO <ysato444@yahoo.co.jp>
 .\" Updated 2008-09-16, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
 .\"
-.TH SIN 3  2009-02-04 "" "Linux Programmer's Manual"
-.\"O .SH NAME
-.SH Ì¾Á°
-.\"O sin, sinf, sinl \- sine function
-sin, sinf, sinl \- Àµ¸¹ (¥µ¥¤¥ó) ´Ø¿ô
-.\"O .SH SYNOPSIS
-.SH ½ñ¼°
+.TH SIN 3 2013\-12\-16 "" "Linux Programmer's Manual"
+.SH 名前
+sin, sinf, sinl \- 正弦 (サイン) 関数
+.SH 書式
 .nf
-.B #include <math.h>
+\fB#include <math.h>\fP
 .sp
-.BI "double sin(double " x );
+\fBdouble sin(double \fP\fIx\fP\fB);\fP
 .br
-.BI "float sinf(float " x );
+\fBfloat sinf(float \fP\fIx\fP\fB);\fP
 .br
-.BI "long double sinl(long double " x );
+\fBlong double sinl(long double \fP\fIx\fP\fB);\fP
 .fi
 .sp
-.\"O Link with \fI\-lm\fP.
-\fI\-lm\fP ¤Ç¥ê¥ó¥¯¤¹¤ë¡£
+\fI\-lm\fP でリンクする。
 .sp
 .in -4n
-.\"O Feature Test Macro Requirements for glibc (see
-.\"O .BR feature_test_macros (7)):
-glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
-.RB ( feature_test_macros (7)
-»²¾È):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
 .in
 .sp
 .ad l
-.BR sinf (),
-.BR sinl ():
-_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or
-.I cc\ -std=c99
-.ad b
-.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
-.\"O The
-.\"O .BR sin ()
-.\"O function returns the sine of \fIx\fP, where \fIx\fP is
-.\"O given in radians.
-.BR sin ()
-´Ø¿ô¤Ï \fIx\fP ¤ÎÀµ¸¹ (¥µ¥¤¥ó) ¤ÎÃͤòÊÖ¤¹¡£
-\fIx\fP ¤Ï¥é¥¸¥¢¥óñ°Ì¤Ç»ØÄꤹ¤ë¡£
-.\"O .SH RETURN VALUE
-.SH ÊÖ¤êÃÍ
-.\"O On success, these functions return the sine of
-.\"O .IR x .
-À®¸ù¤¹¤ë¤È¡¢¤³¤ì¤é¤Î´Ø¿ô¤Ï
-.I x
-¤ÎÀµ¸¹¤òÊÖ¤¹¡£
+\fBsinf\fP(), \fBsinl\fP():
+.RS 4
+_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE
+|| _POSIX_C_SOURCE\ >=\ 200112L;
+.br
+or \fIcc\ \-std=c99\fP
+.RE
+.ad
+.SH 説明
+\fBsin\fP()  関数は \fIx\fP の正弦 (サイン) の値を返す。 \fIx\fP はラジアン単位で指定する。
+.SH 返り値
+成功すると、これらの関数は \fIx\fP の正弦を返す。
 
-.\"O If
-.\"O .I x
-.\"O is a NaN, a NaN is returned.
-.I x
-¤¬ NaN ¤Î¾ì¹ç¡¢NaN ¤¬ÊÖ¤µ¤ì¤ë¡£
+\fIx\fP が NaN の場合、NaN が返される。
 
-.\"O If
-.\"O .I x
-.\"O is positive infinity or negative infinity,
-.\"O a domain error occurs,
-.\"O and a NaN is returned.
-.I x
-¤¬Àµ¤Î̵¸ÂÂ礫Éé¤Î̵¸ÂÂç¤Î¾ì¹ç¡¢
-Îΰ襨¥é¡¼ (domain error) ¤¬È¯À¸¤·¡¢NaN ¤¬ÊÖ¤µ¤ì¤ë¡£
 .\"
 .\" POSIX.1 allows an optional range error for subnormal x
 .\" glibc 2.8 doesn't do this
-.\"O .SH ERRORS
-.SH ¥¨¥é¡¼
-.\"O See
-.\"O .BR math_error (7)
-.\"O for information on how to determine whether an error has occurred
-.\"O when calling these functions.
-¤³¤ì¤é¤Î´Ø¿ô¤ò¸Æ¤Ó½Ð¤·¤¿ºÝ¤Ë¥¨¥é¡¼¤¬È¯À¸¤·¤¿¤«¤ÎȽÄêÊýË¡¤Ë¤Ä¤¤¤Æ¤Î¾ðÊó¤Ï
-.BR math_error (7)
-¤ò»²¾È¤Î¤³¤È¡£
-.PP
-.\"O The following errors can occur:
-°Ê²¼¤Î¥¨¥é¡¼¤¬È¯À¸¤¹¤ë²ÄǽÀ­¤¬¤¢¤ë¡£
-.TP
-.\"O Domain error: \fIx\fP is an infinity
-Îΰ襨¥é¡¼ (domain error): \fIx\fP ¤¬Ìµ¸ÂÂç
-.\" .I errno
-.\" is set to
-.\" .BR EDOM .
-.\"O An invalid floating-point exception
-.\"O .RB ( FE_INVALID )
-.\"O is raised.
-ÉÔÀµ (invalid) ÉâÆ°¾®¿ôÅÀÎã³°
-.RB ( FE_INVALID )
-¤¬¾å¤¬¤ë¡£
+\fIx\fP が正の無限大か負の無限大の場合、 領域エラー (domain error) が発生し、NaN が返される。
+.SH エラー
+これらの関数を呼び出した際にエラーが発生したかの判定方法についての情報は \fBmath_error\fP(7)  を参照のこと。
 .PP
-.\"O These functions do not set
-.\"O .IR errno .
-¤³¤ì¤é¤Î´Ø¿ô¤Ï
-.I errno
-¤òÀßÄꤷ¤Ê¤¤¡£
-.\" FIXME . Is it intentional that these functions do not set errno?
-.\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6781
-.\"O .SH "CONFORMING TO"
-.SH ½àµò
-C99, POSIX.1-2001.
-.\"O The variant returning
-.\"O .I double
-.\"O also conforms to
-.\"O SVr4, 4.3BSD, C89.
-.I double
-ÈǤδؿô¤Ï SVr4, 4.3BSD, C89 ¤Ë¤â½àµò¤·¤Æ¤¤¤ë¡£
-.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
-.BR acos (3),
-.BR asin (3),
-.BR atan (3),
-.BR atan2 (3),
-.BR cos (3),
-.BR csin (3),
-.BR sincos (3),
-.BR tan (3)
+以下のエラーが発生する可能性がある。
+.TP 
+領域エラー (domain error): \fIx\fP が無限大である
+\fIerrno\fP に \fBEDOM\fP が設定される (「バグ」の節も参照)。 不正 (invalid) 浮動小数点例外 (\fBFE_INVALID\fP)
+が上がる。
+.SH 属性
+.SS "マルチスレッディング (pthreads(7) 参照)"
+関数 \fBsin\fP(), \fBsinf\fP(), \fBsinl\fP() はスレッドセーフである。
+.SH 準拠
+C99, POSIX.1\-2001.  \fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠している。
+.SH バグ
+.\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=6781
+バージョン 2.10 より前の glibc の実装では、 領域エラーが発生した際に、 \fIerror\fP に \fBEDOM\fP が設定されなかった。
+.SH 関連項目
+\fBacos\fP(3), \fBasin\fP(3), \fBatan\fP(3), \fBatan2\fP(3), \fBcos\fP(3), \fBcsin\fP(3),
+\fBsincos\fP(3), \fBtan\fP(3)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.67 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。