OSDN Git Service

Update README
[linuxjm/LDP_man-pages.git] / draft / man3 / ecvt.3
index 1e43ede..30113e3 100644 (file)
@@ -1,5 +1,6 @@
 .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
 .\"
+.\" %%%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.
@@ -19,6 +20,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
 .\" Modified Sat Jul 24 19:40:39 1993 by Rik Faith (faith@cs.unc.edu)
 .\" Modified Fri Jun 25 12:10:47 1999 by Andries Brouwer (aeb@cwi.nl)
 .\"
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.\"
 .\" Japanese Version Copyright (c) 1997 Hiroaki Nagoya
 .\"         all rights reserved.
 .\" Translated Mon Feb 10 1997 by Hiroaki Nagoya <nagoya@is.titech.ac.jp>
 .\" Updated 2000-01-08 by Kentaro Shirakata <argrath@ub32.org>
 .\" Updated 2009-04-22 by Kentaro Shirakata <argrath@ub32.org>
 .\"
-.TH ECVT 3 2010-09-20 "" "Linux Programmer's Manual"
-.\"O .SH NAME
-.SH Ì¾Á°
-.\"O ecvt, fcvt \- convert a floating-point number to a string
-ecvt, fcvt \- ÉâÆ°¾®¿ôÅÀ¿ô¤Îʸ»úÎó¤Ø¤ÎÊÑ´¹
-.\"O .SH SYNOPSIS
-.SH ½ñ¼°
-.B #include <stdlib.h>
+.TH ECVT 3 2014\-08\-19 "" "Linux Programmer's Manual"
+.SH 名前
+ecvt, fcvt \- 浮動小数点数の文字列への変換
+.SH 書式
+\fB#include <stdlib.h>\fP
 .sp
-.BI "char *ecvt(double " number ", int " ndigits ", int *" decpt ,
-.BI "int *" sign );
+\fBchar *ecvt(double \fP\fInumber\fP\fB, int \fP\fIndigits\fP\fB, int *\fP\fIdecpt\fP\fB,\fP
+\fBint *\fP\fIsign\fP\fB);\fP
 .sp
-.BI "char *fcvt(double " number ", int " ndigits ", int *" decpt ,
-.BI "int *" sign );
+\fBchar *fcvt(double \fP\fInumber\fP\fB, int \fP\fIndigits\fP\fB, int *\fP\fIdecpt\fP\fB,\fP
+\fBint *\fP\fIsign\fP\fB);\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
-.BR ecvt (),
-.BR fcvt ():
+\fBecvt\fP(), \fBfcvt\fP():
 .ad l
 .RS 4
 .PD 0
-.TP 4
-.\"O Since glibc 2.12:
-glibc 2.12 °Ê¹ß:
+.TP  4
+glibc 2.12 以降:
 .nf
 _SVID_SOURCE ||
     (_XOPEN_SOURCE\ >=\ 500 ||
         _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED) &&
     !(_POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600)
 .fi
-.TP 4
-.\"O Before glibc 2.12:
-glibc 2.12 ¤è¤êÁ°:
-_SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 ||
-_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
+.TP  4
+glibc 2.12 より前:
+_SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
 .PD
 .RE
 .ad b
-.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
-.\"O The
-.\"O .BR ecvt ()
-.\"O function converts \fInumber\fP to a null-terminated
-.\"O string of \fIndigits\fP digits (where \fIndigits\fP is reduced to a
-.\"O system-specific limit determined by the precision of a
-.\"O .IR double ),
-.\"O and returns a pointer to the string.
-.\"O The high-order digit is nonzero, unless
-.\"O .I number
-.\"O is zero.
-.\"O The low order digit is rounded.
-´Ø¿ô
-.BR ecvt ()
-¤Ï \fInumber\fP ¤ò NUL Ê¸»ú¤Ç½ªÃ¼¤µ¤ì¤¿
-\fIndigits\fP Ê¸»ú¤Îʸ»úÎó¤ØÊÑ´¹¤·¡¢¤½¤Îʸ»úÎó¤Ø¤Î¥Ý¥¤¥ó¥¿¤òÊÖ¤¹
-(\fIndigits\fP ¤¬
-.I double
-¤ÎÀºÅ٤ˤè¤Ã¤Æ·èÄꤵ¤ì¤ë¥·¥¹¥Æ¥à°Í¸¤Î¾å¸ÂÃͤè¤êÂ礭¤¤¾ì¹ç¤Ï¡¢
-¤½¤Î¾ò·ïÃͤ¬ \fIndigits\fP ¤ÎÃͤȤʤë)¡£
-.I number
-¤¬ 0 ¤Ç¤Ê¤±¤ì¤Ð¡¢ºÇ¾å°Ì¤Î·å¤Ï 0 °Ê³°¤Ç¤¢¤ë¡£
-ºÇ²¼°Ì¤Î·å¤Ï´Ý¤á¤é¤ì¤ë¡£
-.\"O The string itself does not contain a decimal point; however,
-.\"O the position of the decimal point relative to the start of the string
-.\"O is stored in \fI*decpt\fP.
-.\"O A negative value for \fI*decpt\fP means that
-.\"O the decimal point is to the left of the start of the string.
-.\"O If the sign of
-.\"O \fInumber\fP is negative, \fI*sign\fP is set to a nonzero value,
-.\"O otherwise it's set to 0.
-.\"O If
-.\"O .I number
-.\"O is zero, it is unspecified whether \fI*decpt\fP is 0 or 1.
-ʸ»úÎó¤Ë¤Ï¾®¿ôÅÀ¤Ï´Þ¤Þ¤ì¤Ê¤¤¡£¤½¤Î¤«¤ï¤ê¤Ë¡¢Ê¸»úÎó¤ÎÀèƬ¤«¤é¤Î¾®¿ôÅÀ¤Î
-°ÌÃÖ¤¬ \fI*decpt\fP ¤ËÊÝ»ý¤µ¤ì¤ë¡£
-\fI*decpt\fP ¤¬Éé¤ÎÃͤξì¹ç¡¢¾®¿ôÅÀ¤¬Ê¸»úÎó¤ÎÀèƬ¤Îº¸Â¦¤Ë¤¢¤ë¤³¤È¤ò°ÕÌ£¤¹¤ë¡£
-¤â¤·(\fInumber\fP¤Î)Éä¹æ¤¬Éé¤Ê¤é¤Ð \fI*sign\fP ¤Ï 0 °Ê³°¤ÎÃͤˡ¢
-¤½¤¦¤Ç¤Ê¤±¤ì¤Ð 0 ¤ËÀßÄꤵ¤ì¤ë¡£
-.I number
-¤¬ 0 ¤Ê¤é¡¢\fI*decpt\fP ¤¬ 0 ¤« 1 ¤«¤Ï̤µ¬Äê¤Ç¤¢¤ë¡£
+.SH 説明
+関数 \fBecvt\fP()  は \fInumber\fP をヌル文字で終端された \fIndigits\fP 文字の文字列へ変換し、その文字列へのポインターを返す
+(\fIndigits\fP が \fIdouble\fP の精度によって決定されるシステム依存の上限値より大きい場合は、 その条件値が \fIndigits\fP
+の値となる)。 \fInumber\fP が 0 でなければ、最上位の桁は 0 以外である。 最下位の桁は丸められる。
+文字列には小数点は含まれない。そのかわりに、文字列の先頭からの小数点の 位置が \fI*decpt\fP に保持される。 \fI*decpt\fP
+が負の値の場合、小数点が文字列の先頭の左側にあることを意味する。 もし(\fInumber\fPの)符号が負ならば \fI*sign\fP は 0 以外の値に、
+そうでなければ 0 に設定される。 \fInumber\fP が 0 なら、\fI*decpt\fP が 0 か 1 かは未規定である。
 .PP
-.\"O The
-.\"O .BR fcvt ()
-.\"O function is identical to
-.\"O .BR ecvt (),
-.\"O except that
-.\"O \fIndigits\fP specifies the number of digits after the decimal point.
-´Ø¿ô
-.BR fcvt ()
-¤Ï
-.BR ecvt ()
-¤ÈƱ¤¸µ¡Ç½¤ò»ý¤Ä¤¬¡¢\fIndigits\fP ¤Ï¾®¿ôÅÀ°Ê²¼¤Îʸ»ú¿ô¤ò»ØÄꤹ¤ë¡£
-.\"O .SH "RETURN VALUE"
-.SH ÊÖ¤êÃÍ
-.\"O Both the
-.\"O .BR ecvt ()
-.\"O and
-.\"O .BR fcvt ()
-.\"O functions return a pointer to a
-.\"O static string containing the ASCII representation of \fInumber\fP.
-´Ø¿ô
-.BR ecvt ()
-¤È
-.BR fcvt ()
-¤Ï \fInumber\fP ¤Î ASCII É½¸½¤ò´Þ¤à
-ÀÅŪ¤ÊÎΰèÆâ¤Îʸ»úÎó¤Ø¤Î¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£
-.\"O The static string is overwritten by each call to
-.\"O .BR ecvt ()
-.\"O or
-.\"O .BR fcvt ().
-¤³¤Îʸ»úÎó¤Ï
-.BR ecvt ()
-¤ä
-.BR fcvt ()
-¤Î¸Æ¤Ó½Ð¤·¤Î¤¿¤Ó¤Ë¾å½ñ¤­¤µ¤ì¤ë¡£
-.\"O .SH "CONFORMING TO"
-.SH ½àµò
-.\"O SVr2;
-.\"O marked as LEGACY in POSIX.1-2001.
-SVr2¡£
-POSIX.1-2001 ¤Ç¤Ï¡Ö²áµî¤Î̾»Ä (LEGACY)¡×¤È°ÌÃÖÉÕ¤±¤é¤ì¤Æ¤¤¤ë¡£
-.\"O POSIX.1-2008 removes the specifications of
-.\"O .BR ecvt ()
-.\"O and
-.\"O .BR fcvt (),
-.\"O recommending the use of
-.\"O .BR sprintf (3)
-.\"O instead (though
-.\"O .BR snprintf (3)
-.\"O may be preferable).
-POSIX.1-2008 ¤Ç¤Ï
-.BR ecvt ()
-¤È
-.BR fcvt ()
-¤Î»ÅÍͤ¬ºï½ü¤µ¤ì¡¢Âå¤ï¤ê¤Ë
-.BR sprintf (3)
-¤Î»ÈÍѤ¬¿ä¾©¤µ¤ì¤Æ¤¤¤ë(¤·¤«¤·
-.BR snprintf (3)
-¤¬¤è¤êŬÀÚ¤«¤â¤·¤ì¤Ê¤¤)¡£
-.\"O .SH NOTES
-.SH Ãí°Õ
-.\"O Linux libc4 and libc5 specified the type of
-.\"O .I ndigits
-.\"O as
-.\"O .IR size_t .
-Linux libc4 ¤È libc5 ¤Ç¤Ï
-.I ndigits
-¤Î·¿¤Ï
-.I size_t
-¤È¤Ê¤Ã¤Æ¤¤¤¿¡£
-.\"O Not all locales use a point as the radix character ("decimal point").
-¾®¿ôÅÀ¤Ë¥Ô¥ê¥ª¥É¤ò»È¤ï¤Ê¤¤¥í¥±¡¼¥ë¤â¤¢¤ë¡£
-.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
-.BR ecvt_r (3),
-.BR gcvt (3),
-.BR qecvt (3),
-.BR setlocale (3),
-.BR sprintf (3)
+関数 \fBfcvt\fP()  は \fBecvt\fP()  と同じ機能を持つが、\fIndigits\fP は小数点以下の文字数を指定する。
+.SH 返り値
+関数 \fBecvt\fP()  と \fBfcvt\fP()  は \fInumber\fP の ASCII 表現を含む 静的な領域内の文字列へのポインターを返す。
+この文字列は \fBecvt\fP()  や \fBfcvt\fP()  の呼び出しのたびに上書きされる。
+.SH 属性
+.SS "マルチスレッディング (pthreads(7) 参照)"
+関数 \fBecvt\fP() と \fBfcvt\fP() はスレッドセーフではない。
+.SH 準拠
+SVr2。 POSIX.1\-2001 では「過去の名残 (LEGACY)」と位置付けられている。 POSIX.1\-2008 では \fBecvt\fP()
+と \fBfcvt\fP()  の仕様が削除され、代わりに \fBsprintf\fP(3)  の使用が推奨されている(しかし \fBsnprintf\fP(3)
+がより適切かもしれない)。
+.SH 注意
+.\" Linux libc4 and libc5 specified the type of
+.\" .I ndigits
+.\" as
+.\" .IR size_t .
+小数点にピリオドを使わないロケールもある。
+.SH 関連項目
+\fBecvt_r\fP(3), \fBgcvt\fP(3), \fBqecvt\fP(3), \fBsetlocale\fP(3), \fBsprintf\fP(3)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。