名称

getc, getchar, fgetc, getw  −  ストリームから文字またはワードを得る

形式

#include <stdio.h>

int getc(stream)
FILE ∗stream;

int getchar()

int fgetc(stream)
FILE ∗stream;

int getw(stream)
FILE ∗stream;

解説

getc は、 指定した入力 stream から次の文字を返します。

getchar() は getc(stdin) と同じです。

fgetc は getc のように動作しますが、 マクロではなく純粋な関数です。 テキストを 節約するのに使用できます。

getw は、 指定した入力 stream から次の int (NEWS上では 32 ビット整数)を返します。 getw は、 ファイルの終わりまたはエラー時には定数 EOF を返します。 しかし、これは正常な整数値ですから、 feof と ferror(3S) を使用して、 getw の正常終了をチェックする必要があります。 getw はファイルに特別な境界合わせがないと仮定しています。

関連事項

clearerr(3S), fopen(3S), putc(3S), getc(3S), scanf(3S), fread(3S), ungetc(3S)

診断

これらの関数は、 ファイルの終わり、 読み込みエラー、 または fopen でオープンされていないファイルを 読もうとした場合には、 整数定数 EOF を返します。 end-of-file (ファイルの終わり) の条件は保持され(端末上においても)、 clearerr(3S) でこの条件をクリアするまで、 後続の読み込みでは EOF が返されることになります。

バグ

getc は、マクロとして実現されているので、 副作用のため stream 引数を正しく処理できないことがあります。 特に、 getc(∗f++); は思っているようには動作しません。

NEWS-OSRelease 4.2.1R