Man page - fgets(3)

Packages contains this manual

Available languages:

en fr ja ru ro

Manual

FGETC

名 前
書 式
説 明
返 り 値
属 性
準 拠
関 連 項 目
こ の 文 書 に つ い て

名 前

fgetc, fgets, getc, getchar, ungetc - 文 字 と 文 字 列 の 入 力

書 式

#include <stdio.h>

int fgetc(FILE * stream );

char *fgets(char * s , int size , FILE * stream );

int getc(FILE * stream );

int getchar(void);

int ungetc(int c , FILE * stream );

説 明

fgetc () は 、 stream か ら 次 の 文 字 を unsigned char と し て 読 み 、 int に キ ャ ス ト し て 返 す 。 フ ァ イ ル の 終 わ り や エ ラ ー と な っ た 場 合 は EOF を 返 す 。

getc () は fgetc () と 同 様 だ が 、 stream を 複 数 回 評 価 す る マ ク ロ と し て 実 装 さ れ て い る か も し れ な い 。

getchar () は getc( stdin ) と 同 じ で あ る 。

fgets () は stream か ら 最 大 で size - 1 個 の 文 字 を 読 み 込 み 、 s が 指 す バ ッ フ ァ ー に 格 納 す る 。 読 み 込 み は EOF ま た は 改 行 文 字 を 読 み 込 ん だ 後 で 停 止 す る 。 読 み 込 ま れ た 改 行 文 字 は バ ッ フ ァ ー に 格 納 さ れ る 。 終 端 の ヌ ル バ イ ト ('\0') が 一 つ バ ッ フ ァ ー の 中 の 最 後 の 文 字 の 後 に 書 き 込 ま れ る 。

ungetc () は 、 後 の read 操 作 で 読 め る よ う に 、 c を unsigned char に キ ャ ス ト し て stream に 書 き 戻 す 。 書 き 戻 さ れ た 文 字 は 逆 順 に 戻 さ れ る ; 書 き 戻 し と し て 保 証 さ れ て い る の は 、 一 文 字 だ け で あ る 。

こ こ で 述 べ た 関 数 や stdio ラ イ ブ ラ リ の 入 力 関 数 を 同 じ 入 力 ス ト リ ー ム に 対 し て 互 い に 混 ぜ て 使 う こ と が で き る 。

こ れ ら の 処 理 を 停 止 せ ず に 行 い た い と き は 、 unlocked_stdio (3) を 参 照 の こ と 。

返 り 値

fgetc (), getc (), getchar () は 、 文 字 を unsigned char と し て 読 ん で int に キ ャ ス ト し て 返 す 。 フ ァ イ ル の 終 わ り や エ ラ ー の 場 合 は EOF を 返 す 。

fgets () は 、 成 功 す る と s を 返 し 、 エ ラ ー や 1 文 字 も 読 み 込 ん で い な い の に フ ァ イ ル の 終 わ り に な っ た 場 合 に NULL を 返 す 。

ungetc () は 成 功 す る と c を 返 し 、 エ ラ ー の 場 合 は EOF を 返 す 。

属 性

こ の 節 で 使 用 さ れ て い る 用 語 の 説 明 に つ い て は 、 attributes (7) を 参 照 。

Image grohtml-18416-1.png

準 拠

POSIX.1-2001, POSIX.1-2008, C89, C99.

入 力 ス ト リ ー ム の フ ァ イ ル デ ィ ス ク リ プ タ ー に 対 し て 、 stdio ラ イ ブ ラ リ の 入 力 関 数 と 、 低 レ ベ ル 呼 び 出 し の read (2) を 混 ぜ て 呼 び 出 す 事 は 勧 め ら れ な い 。 結 果 が ど う な る か は 分 か ら ず 、 お そ ら く あ な た の 望 ん で い る 結 果 に は な ら な い だ ろ う 。

関 連 項 目

read (2), write (2), ferror (3), fgetwc (3), fgetws (3), fopen (3), fread (3), fseek (3), getline (3), gets (3), getwchar (3), puts (3), scanf (3), ungetwc (3), unlocked_stdio (3), feature_test_macros (7)

こ の 文 書 に つ い て

こ の man ペ ー ジ は Linux man-pages プ ロ ジ ェ ク ト の リ リ ー ス 5.10 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は https://www.kernel.org/doc/man-pages/ に 書 か れ て い る 。