GETC
Section: C Library Functions (3)
索引
jman
BSD mandoc
索引
名称
fgetc
getc
getchar
getw
- 入力ストリームから次の文字またはワードを取得
索引
ライブラリ
Lb libc
索引
書式
In stdio.h
Ft int
Fn fgetc FILE *stream
Ft int
Fn getc FILE *stream
Ft int
Fn getchar
Ft int
Fn getw FILE *stream
索引
解説
Fn fgetc
関数は、
Fa stream
で指したストリームから、(存在している場合) 次の入力文字を取得するか、
または、
ungetc(3)
によってそのストリームにプッシュバックされた、次の文字を取得します。
Fn getc
関数は
Fn fgetc
と基本的に同じ機能ですが、これはインラインで展開するマクロです。
Fn getchar
関数は、
引数 stdin がついている
Fn getc
と同等です。
Fn getw
関数は
Fa stream
で指したストリームから、次の
int
を (存在している場合) 取得します。
索引
戻り値
処理が正常に完了した場合、これらのルーチンはいずれも
Fa stream
から次の要求オブジェクトを返します。
ストリームがファイルの終わりに達したか、
または読込みエラーが発生した場合は
EOF
を返します。
ファイルの終わりか、エラーなのかを識別するには、
feof(3)
と
ferror(3)
ルーチンを使用する必要があります。
エラーが発生した場合は、グローバル変数
errno
にエラーを示す値が設定されます。
ファイルの終端を示す状態は端末であってもそのまま残り、
その後の読み込みに対しては
clearerr(3)
によって状態がクリアされなければ
EOF
を返すことになります。
索引
関連項目
ferror(3),
fopen(3),
fread(3),
putc(3),
ungetc(3)
索引
規格
Fn fgetc ,
Fn getc
および
Fn getchar
関数は、
St -isoC
に適合しています。
索引
バグ
EOF
は、有効な整数値なので
Fn getw
を呼び出した後のエラーをチェックするには、
feof(3)
および
ferror(3)
を使用する必要があります。
int
のサイズとバイト順はマシンによってさまざまです。
移植可能なアプリケーションが目的なら、
Fn getw
の使用は推奨できません。
索引
Index
- 名称
-
- ライブラリ
-
- 書式
-
- 解説
-
- 戻り値
-
- 関連項目
-
- 規格
-
- バグ
-
Time: 07:06:49 GMT, January 12, 2009