.\" the source, must acknowledge the copyright and authors of this work.
.\" License.
.\" Modified Wed Jul 28 11:12:07 1993 by Rik Faith (faith@cs.unc.edu)
+.\" Modified Fri Sep 8 15:48:13 1995 by Andries Brouwer (aeb@cwi.nl)
+.\"*******************************************************************
.\"
-.\" Japanese Version Copyright (c) 1997 IMAMURA Nobutaka
-.\" all rights reserved.
-.\" Translated 1997-02-14, IMAMURA Nobutaka <imamura@spp.hpc.fujitsu.co.jp>
-.\" Updated 1999-08-29, Kentaro Shirakata <argrath@ub32.org>
-.\" Updated 2001-11-02, Kentaro Shirakata <argrath@ub32.org>
-.\" Updated 2005-09-06, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
+.\" This file was generated with po4a. Translate the source file.
.\"
-.TH GETS 3 2011-09-28 "GNU" "Linux Programmer's Manual"
+.\"*******************************************************************
+.TH GETS 3 2012\-01\-18 GNU "Linux Programmer's Manual"
.SH 名前
fgetc, fgets, getc, getchar, gets, ungetc \- 文字と文字列の入力
.SH 書式
.nf
-.B #include <stdio.h>
+\fB#include <stdio.h>\fP
.sp
-.BI "int fgetc(FILE *" stream );
+\fBint fgetc(FILE *\fP\fIstream\fP\fB);\fP
-.BI "char *fgets(char *" "s" ", int " "size" ", FILE *" "stream" );
+\fBchar *fgets(char *\fP\fIs\fP\fB, int \fP\fIsize\fP\fB, FILE *\fP\fIstream\fP\fB);\fP
-.BI "int getc(FILE *" stream );
+\fBint getc(FILE *\fP\fIstream\fP\fB);\fP
-.B "int getchar(void);"
+\fBint getchar(void);\fP
-.BI "char *gets(char *" "s" );
+\fBchar *gets(char *\fP\fIs\fP\fB);\fP
-.BI "int ungetc(int " c ", FILE *" stream );
+\fBint ungetc(int \fP\fIc\fP\fB, FILE *\fP\fIstream\fP\fB);\fP
.fi
.SH 説明
-.BR fgetc ()
-は、
-.I stream
-から次の文字を
-.I unsigned char
-として読み、
-.I int
-にキャストして返す。ファイルの終わりやエラーとなった場合は
-.B EOF
-を返す。
+\fBfgetc\fP() は、 \fIstream\fP から次の文字を \fIunsigned char\fP として読み、 \fIint\fP
+にキャストして返す。ファイルの終わりやエラーとなった場合は \fBEOF\fP を返す。
.PP
-.BR getc ()
-は
-.BR fgetc ()
-と同様だが、
-.I stream
-を複数回評価するマクロとして実装されているかもしれない。
+\fBgetc\fP() は \fBfgetc\fP() と同様だが、 \fIstream\fP を複数回評価するマクロとして実装されているかもしれない。
.PP
-.BR getchar ()
-は
-.BI "getc(" stdin ) \fR
-と同じである。
+\fBgetchar\fP() は \fBgetc(\fP\fIstdin\fP\fB)\fP と同じである。
.PP
-.BR gets ()
-は、改行文字か
-.B EOF
-までの 1行を
-.I stdin
-から読み込み
-.I s
-が指すバッファに格納する
-(末尾の改行文字や
-.B EOF
-は NULL バイト (\(aq\e0\(aq) に置き換えられる)。
-バッファ・オーバーランのチェックは行われない (下記の「バグ」を参照)。
+\fBgets\fP() は、改行文字か \fBEOF\fP までの 1行を \fIstdin\fP から読み込み \fIs\fP が指すバッファに格納する
+(末尾の改行文字や \fBEOF\fP は NULL バイト (\(aq\e0\(aq) に置き換えられる)。 バッファオーバーランのチェックは行われない
+(下記の「バグ」を参照)。
.PP
-.BR fgets ()
-は
-.I stream
-から最大で
-.IR size " - 1"
-個の文字を読み込み、
-.I s
-が指すバッファに格納する。読み込みは
-.B EOF
-または改行文字を読み込んだ後で停止する。
-読み込まれた改行文字はバッファに格納される。
-終端の NULL バイト (\(aq\e0\(aq)
-が一つバッファの中の最後の文字の後に書き込まれる。
+\fBfgets\fP() は \fIstream\fP から最大で \fIsize\fP \- 1 個の文字を読み込み、 \fIs\fP が指すバッファに格納する。読み込みは
+\fBEOF\fP または改行文字を読み込んだ後で停止する。 読み込まれた改行文字はバッファに格納される。 終端の NULL バイト
+(\(aq\e0\(aq) が一つバッファの中の最後の文字の後に書き込まれる。
.PP
-.BR ungetc ()
-は、後の read 操作で読めるように、
-.I c
-を
-.I "unsigned char"
-にキャストして
-.I stream
-に書き戻す。
-書き戻された文字は逆順に戻される;
-書き戻しとして保証されているのは、一文字だけである。
+\fBungetc\fP() は、後の read 操作で読めるように、 \fIc\fP を \fIunsigned char\fP にキャストして \fIstream\fP
+に書き戻す。 書き戻された文字は逆順に戻される; 書き戻しとして保証されているのは、一文字だけである。
.PP
-ここで述べた関数や
-.I stdio
-ライブラリの入力関数を同じ入力ストリームに対して互いに混ぜて使うことができる。
+ここで述べた関数や \fIstdio\fP ライブラリの入力関数を同じ入力ストリームに対して互いに混ぜて使うことができる。
.PP
-これらの処理をロックせずに行いたいときは、
-.BR unlocked_stdio (3)
-を参照のこと。
+これらの処理を停止せずに行いたいときは、 \fBunlocked_stdio\fP(3) を参照のこと。
.SH 返り値
-.BR fgetc (),
-.BR getc (),
-.BR getchar ()
-は、文字を
-.I unsigned char
-として読んで
-.I int
-にキャストして返す。ファイルの終わりやエラーの場合は
-.B EOF
-を返す。
+\fBfgetc\fP(), \fBgetc\fP(), \fBgetchar\fP() は、文字を \fIunsigned char\fP として読んで \fIint\fP
+にキャストして返す。ファイルの終わりやエラーの場合は \fBEOF\fP を返す。
.PP
-.BR gets ()
-と
-.BR fgets ()
-は、成功すると
-.I s
-を返し、エラーや 1 文字も読み込んでいないのにファイルの終わりになった
+\fBgets\fP() と \fBfgets\fP() は、成功すると \fIs\fP を返し、エラーや 1 文字も読み込んでいないのにファイルの終わりになった
場合に NULL を返す。
.PP
-.BR ungetc ()
-は成功すると
-.I c
-を返し、エラーの場合は
-.B EOF
-を返す。
+\fBungetc\fP() は成功すると \fIc\fP を返し、エラーの場合は \fBEOF\fP を返す。
.SH 準拠
-C89, C99, POSIX.1-2001.
-LSB では
-.BR gets ()
-は非推奨である。
-POSIX.1-2008 では
-.BR gets ()
-は廃止予定であるとされている。
+C89, C99, POSIX.1\-2001.
+
+LSB は \fBgets\fP() を非推奨としている。
+POSIX.1\-2008 では \fBgets\fP() に廃止予定の印が付けられている。
+ISO C11 では \fBgets\fP)() の規定が C 言語から削除されている。
+glibc バージョン 2.16 以降では、機能検査マシン \fB_ISOC11_SOURCE\fP が定義された
+場合、glibc ヘッダファイルでは \fBgets\fP)() の宣言が公開されない。
.SH バグ
-.BR gets ()
-は絶対に使用してはならない。
-前もってデータを知ることなしに
-.BR gets ()
-が何文字読むかを知ることはできず、
-.BR gets ()
-がバッファの終わりを越えて書き込み続けるため、
-.BR gets ()
-を使うのは極めて危険である。
-これを利用してコンピュータのセキュリティが破られてきた。
-代わりに
-.BR fgets ()
-を使うこと。
+\fBgets\fP() は絶対に使用してはならない。 前もってデータを知ることなしに \fBgets\fP() が何文字読むかを知ることはできず、
+\fBgets\fP() がバッファの終わりを越えて書き込み続けるため、 \fBgets\fP() を使うのは極めて危険である。
+これを利用してコンピュータのセキュリティが破られてきた。 代わりに \fBfgets\fP() を使うこと。
.PP
-入力ストリームのファイルディスクリプタに対して、
-.I stdio
-ライブラリの入力関数と、低レベル呼び出しの
-.BR read (2)
-を混ぜて呼び出す事は勧められない。
-結果がどうなるかは分からず、おそらくあなたの
-望んでいる結果にはならないだろう。
+入力ストリームのファイルディスクリプタに対して、 \fIstdio\fP ライブラリの入力関数と、低レベル呼び出しの \fBread\fP(2)
+を混ぜて呼び出す事は勧められない。 結果がどうなるかは分からず、おそらくあなたの 望んでいる結果にはならないだろう。
.SH 関連項目
-.BR read (2),
-.BR write (2),
-.BR ferror (3),
-.BR fgetwc (3),
-.BR fgetws (3),
-.BR fopen (3),
-.BR fread (3),
-.BR fseek (3),
-.BR getline (3),
-.BR getwchar (3),
-.BR puts (3),
-.BR scanf (3),
-.BR ungetwc (3),
-.BR unlocked_stdio (3)
+\fBread\fP(2), \fBwrite\fP(2), \fBferror\fP(3), \fBfgetwc\fP(3), \fBfgetws\fP(3),
+\fBfopen\fP(3), \fBfread\fP(3), \fBfseek\fP(3), \fBgetline\fP(3), \fBgetwchar\fP(3),
+\fBputs\fP(3), \fBscanf\fP(3), \fBungetwc\fP(3), \fBunlocked_stdio\fP(3),
+\fBfeature_test_macros\fP(7)
OSDN Git Service
