OSDN Git Service

(split) LDP: Restore and add Copyrights for draft pages
[linuxjm/LDP_man-pages.git] / draft / man3 / gcvt.3
index d1b0cd4..ae1eb20 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.
 .\"
 .\" 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
 .\"     Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
 .\"     386BSD man pages
 .\" Modified Sat Jul 24 19:32:25 1993 by Rik Faith (faith@cs.unc.edu)
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
 .\"
 .\" Japanese Version Copyright (c) 1997 Hiroaki Nagoya
 .\"         all rights reserved.
 .\" Updated 2008-09-16, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
 .\" Updated 2009-04-24, Akihiro MOTOKI, LDP v3.20
 .\"
-.TH GCVT 3 2010-09-20 "" "Linux Programmer's Manual"
-.\"O .SH NAME
-.SH Ì¾Á°
-.\"O gcvt \- convert a floating-point number to a string
-gcvt \- ÉâÆ°¾®¿ôÅÀ¿ô¤òʸ»úÎó¤ØÊÑ´¹¤¹¤ë
-.\"O .SH SYNOPSIS
-.SH ½ñ¼°
+.TH GCVT 3 2010\-09\-20 "" "Linux Programmer's Manual"
+.SH 名前
+gcvt \- 浮動小数点数を文字列へ変換する
+.SH 書式
 .nf
-.B #include <stdlib.h>
+\fB#include <stdlib.h>\fP
 .sp
-.BI "char *gcvt(double " number ", size_t " ndigit ", char *" buf );
+\fBchar *gcvt(double \fP\fInumber\fP\fB, size_t \fP\fIndigit\fP\fB, char *\fP\fIbuf\fP\fB);\fP
 .fi
 .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 gcvt ():
+\fBgcvt\fP():
 .ad l
 .PD 0
 .RS 4
-.TP 4
-.\"O Since glibc 2.10:
-glibc 2.10 °Ê¹ß:
+.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.10:
-glibc 2.10 ¤è¤êÁ°:
-_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
 .RE
 .PD
 .ad b
-.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
-.\"O The
-.\"O .BR gcvt ()
-.\"O function converts \fInumber\fP to a minimal length null-terminated
-.\"O ASCII string and stores the result in \fIbuf\fP.
-.\"O It produces \fIndigit\fP significant digits in either
-.\"O .BR printf (3)
-.\"O F format or E format.
-´Ø¿ô
-.BR gcvt ()
-¤Ï¡¢ \fInumber\fP ¤ò¡¢ºÇû¤ÎŤµ¤Î NULL ½ªÃ¼¤µ¤ì¤¿ ASCII
-ʸ»úÎó¤ØÊÑ´¹¤·¡¢ÊÑ´¹¸å¤Îʸ»úÎó¤ò \fIbuf\fP ¤Ë³ÊǼ¤¹¤ë¡£
-.BR printf (3)
-¤Î F ¥Õ¥©¡¼¥Þ¥Ã¥È¤ä E ¥Õ¥©¡¼¥Þ¥Ã¥È¤Î¤è¤¦¤Ë \fIndigit\fP ·å¤Î
-Í­¸ú¿ô»ú¤òÀ¸À®¤¹¤ë¡£
-.\"O .SH "RETURN VALUE"
-.SH ÊÖ¤êÃÍ
-.\"O The
-.\"O .BR gcvt ()
-.\"O function returns the address of the string pointed to
-.\"O by \fIbuf\fP.
-´Ø¿ô
-.BR gcvt ()
-¤Ïʸ»úÎó \fIbuf\fP ¤Ø¤Î¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£
-.\"O .SH "CONFORMING TO"
-.SH ½àµò
-.\"O Marked as LEGACY in POSIX.1-2001.
-POSIX.1-2001 ¤Ç¤Ï¡¢
-¤³¤Î´Ø¿ô¤Ï¡Ö²áµî¤Î̾»Ä (LEGACY)¡×¤È°ÌÃÖÉÕ¤±¤é¤ì¤Æ¤¤¤ë¡£
-.\"O POSIX.1-2008 removes the specification of
-.\"O .BR gcvt (),
-.\"O recommending the use of
-.\"O .BR sprintf (3)
-.\"O instead (though
-.\"O .BR snprintf (3)
-.\"O may be preferable).
-POSIX.1-2008 ¤Ç¤Ï¡¢
-.BR gcvt ()
-¤Î»ÅÍͤϺï½ü¤µ¤ì¡¢
-Âå¤ï¤ê¤Ë
-.BR sprintf (3)
-¤ò»ÈÍѤ¹¤ë¤³¤È¤¬¿ä¾©¤µ¤ì¤Æ¤¤¤ë
-.RB ( snprintf (3)
-¤ÎÊý¤¬Å¬ÀÚ¤«¤â¤·¤ì¤Ê¤¤¤¬)¡£
-.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
-.BR ecvt (3),
-.BR fcvt (3),
-.BR sprintf (3)
+.SH 説明
+関数 \fBgcvt\fP()  は、 \fInumber\fP を、最短の長さの NULL 終端された ASCII 文字列へ変換し、変換後の文字列を \fIbuf\fP
+に格納する。 \fBprintf\fP(3)  の F フォーマットや E フォーマットのように \fIndigit\fP 桁の 有効数字を生成する。
+.SH 返り値
+関数 \fBgcvt\fP()  は文字列 \fIbuf\fP へのポインタを返す。
+.SH 準拠
+POSIX.1\-2001 では、 この関数は「過去の名残 (LEGACY)」と位置付けられている。 POSIX.1\-2008 では、 \fBgcvt\fP()
+の仕様は削除され、 代わりに \fBsprintf\fP(3)  を使用することが推奨されている (\fBsnprintf\fP(3)
+の方が適切かもしれないが)。
+.SH 関連項目
+\fBecvt\fP(3), \fBfcvt\fP(3), \fBsprintf\fP(3)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。