X-Git-Url: http://git.osdn.net/view?a=blobdiff_plain;f=draft%2Fman3%2Ffdim.3;h=fe11211c6431951ba33361c5786a8dc39ed0142a;hb=5e1d43dd8cff93ca6fb21fea939c28233332b846;hp=829404dacd3e03d3c15e5ae432d5b7ffef437978;hpb=633a2252e0be3c867dce264a180a89ce8181d36f;p=linuxjm%2FLDP_man-pages.git diff --git a/draft/man3/fdim.3 b/draft/man3/fdim.3 index 829404da..fe11211c 100644 --- a/draft/man3/fdim.3 +++ b/draft/man3/fdim.3 @@ -1,7 +1,16 @@ .\" Copyright 2003 Walter Harms, Andries Brouwer .\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk .\" -.\" Distributed under GPL. +.\" +.\" %%%LICENSE_START(GPL_NOVERSION_ONELINE) +.\" Distributed under GPL +.\" %%%LICENSE_END +.\" +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* .\" .\" Japanese Version Copyright (c) 2004-2005 Yuichi SATO .\" all rights reserved. @@ -10,111 +19,65 @@ .\" Updated & Modified Mon Jan 10 08:17:08 JST 2005 by Yuichi SATO .\" Updated 2008-09-16, Akihiro MOTOKI .\" -.TH FDIM 3 2008-08-11 "" "Linux Programmer's Manual" -.\"O .SH NAME -.SH ̾Á° -.\"O fdim, fdimf, fdiml \- positive difference -fdim, fdimf, fdiml \- Àµ¤Îº¹Ê¬¤ò·×»»¤¹¤ë -.\"O .SH SYNOPSIS -.SH ½ñ¼° -.B #include +.TH FDIM 3 2013\-07\-15 "" "Linux Programmer's Manual" +.SH 名前 +fdim, fdimf, fdiml \- 正の差分を計算する +.SH 書式 +\fB#include \fP .sp -.BI "double fdim(double " x ", double " y ); +\fBdouble fdim(double \fP\fIx\fP\fB, double \fP\fIy\fP\fB);\fP .br -.BI "float fdimf(float " x ", float " y ); +\fBfloat fdimf(float \fP\fIx\fP\fB, float \fP\fIy\fP\fB);\fP .br -.BI "long double fdiml(long double " x ", long double " y ); +\fBlong double fdiml(long double \fP\fIx\fP\fB, long double \fP\fIy\fP\fB);\fP .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 fdimf (), -.BR fdiml (): -_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or -.I cc\ -std=c99 -.ad b -.\"O .SH DESCRIPTION -.SH ÀâÌÀ -.\"O These functions return the positive difference, max(\fIx\fP-\fIy\fP,0), -.\"O between their arguments. -¤³¤ì¤é¤Î´Ø¿ô¤Ï¡¢Æó¤Ä¤Î°ú¤­¿ô´Ö¤ÎÀµ¤Îº¹Ê¬ max(\fIx\fP-\fIy\fP,0) ¤òÊÖ¤¹¡£ -.\"O .SH RETURN VALUE -.SH ÊÖ¤êÃÍ -.\"O On success, these functions return the positive difference. -À®¸ù¤¹¤ë¤È¡¢¤³¤ì¤é¤Î´Ø¿ô¤ÏÀµ¤Îº¹Ê¬¤òÊÖ¤¹¡£ +\fBfdimf\fP(), \fBfdiml\fP(): +.RS 4 +_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L; +.br +or \fIcc\ \-std=c99\fP +.RE +.ad +.SH 説明 +これらの関数は、二つの引き数間の正の差分 max(\fIx\fP\-\fIy\fP,0) を返す。 +.SH 返り値 +成功すると、これらの関数は正の差分を返す。 -.\"O If -.\"O .I x -.\"O or -.\"O .I y -.\"O is a NaN, a NaN is returned. -.I x -¤« -.I y -¤¬ NaN ¤Î¾ì¹ç¡¢NaN ¤¬ÊÖ¤µ¤ì¤ë¡£ +\fIx\fP か \fIy\fP が NaN の場合、NaN が返される。 -.\"O If the result overflows, -.\"O a range error occurs, -.\"O and the functions return -.\"O .BR HUGE_VAL , -.\"O .BR HUGE_VALF , -.\"O or -.\"O .BR HUGE_VALL , -.\"O respectively. -·ë²Ì¤¬¥ª¡¼¥Ð¡¼¥Õ¥í¡¼¤¹¤ë¾ì¹ç¡¢ÈÏ°Ï¥¨¥é¡¼¤¬È¯À¸¤·¡¢ -³Æ´Ø¿ô¤Ï¤½¤ì¤¾¤ì -.BR HUGE_VAL , -.BR HUGE_VALF , -.B HUGE_VALL -¤òÊÖ¤¹¡£ -.\"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) -¤ò»²¾È¤Î¤³¤È¡£ +結果がオーバーフローする場合、範囲エラー (range error) が発生し、 各関数はそれぞれ \fBHUGE_VAL\fP, \fBHUGE_VALF\fP, +\fBHUGE_VALL\fP を返す。 +.SH エラー +これらの関数を呼び出した際にエラーが発生したかの判定方法についての情報は \fBmath_error\fP(7) を参照のこと。 .PP -.\"O The following errors can occur: -°Ê²¼¤Î¥¨¥é¡¼¤¬È¯À¸¤¹¤ë²ÄǽÀ­¤¬¤¢¤ë¡£ -.TP -.\"O Range error: result overflow -ÈÏ°Ï¥¨¥é¡¼ (range error)¡¢¥ª¡¼¥Ð¡¼¥Õ¥í¡¼¤Î¾ì¹ç +以下のエラーが発生する可能性がある。 +.TP +範囲エラー (range error): 結果のオーバーフロー .\" .I errno .\" is set to .\" .BR ERANGE . -.\"O An overflow floating-point exception -.\"O .RB ( FE_OVERFLOW ) -.\"O is raised. -¥ª¡¼¥Ð¡¼¥Õ¥í¡¼ÉâÆ°¾®¿ôÅÀÎã³° -.RB ( FE_OVERFLOW ) -¤¬¾å¤¬¤ë¡£ +オーバーフロー浮動小数点例外 (\fBFE_OVERFLOW\fP) が上がる。 .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=6796 -.\"O .SH VERSIONS -.SH ¥Ð¡¼¥¸¥ç¥ó -.\"O These functions first appeared in glibc in version 2.1. -¤³¤ì¤é¤Î´Ø¿ô¤Ï glibc ¥Ð¡¼¥¸¥ç¥ó 2.1 ¤Ç½é¤á¤ÆÅо줷¤¿¡£ -.\"O .SH "CONFORMING TO" -.SH ½àµò -C99, POSIX.1-2001. -.\"O .SH "SEE ALSO" -.SH ´ØÏ¢¹àÌÜ -.BR fmax (3) +これらの関数は \fIerrno\fP を設定しない。 +.SH バージョン +これらの関数は glibc バージョン 2.1 で初めて登場した。 +.SH 属性 +.SS "マルチスレッディング (pthreads(7) 参照)" +関数 \fBfdim\fP(), \fBfdimf\fP(), \fBfdiml\fP() はスレッドセーフである。 +.SH 準拠 +C99, POSIX.1\-2001. +.SH 関連項目 +\fBfmax\fP(3) +.SH この文書について +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.67 の一部 +である。プロジェクトの説明とバグ報告に関する情報は +http://www.kernel.org/doc/man\-pages/ に書かれている。