HIR-NET Home C言語 運営者 オンラインソフト 運営者著書 CG HIR-NETリンク集

fgetcエフ・ゲット・シー関数かんすう
fgetc function

語源  fileファイオ getゲット characterキャラクター(ファイル文字入力)
分類  C/C++標準ライブラリ/関数/入出力関数/入力関数/文字入力関数
名称  ファイル文字入力関数(file character input function)
対義  fputc関数
同等  fgetwc関数
類似  getc関数
関連  fopen関数
解説  fgetc関数は、ファイルに文字を書き出す関数です。出力ストリーム*stream のファイル位置指示子の位置に、出力文字c を unsigned char に変換した上で書き出します。ファイル位置指示子はその分進められます。ファイルが位置付け要求を実現できないか、ストリームが追加モードでオープンされている場合は出力ストリームに文字が付加されます。

関数原型宣言ヘッダ  <stdio.h>
関数原型宣言例
             入力ストリーム
                  ↓
int fgetc(FILE *stream);
↓
0~UCHAR_MAX:入力文字
EOF         :終了/失敗

関数返却値
①入力した文字を返す。値としては 0~UCHAR_MAX(一般に 0~255)です。
②ストリームがファイルの終わりである場合は、ファイル終了指示子をストリームに設定し EOF(一般に -1)を返します。
③読込エラーが発生した場合はファイル・エラー指示子をストリームに設定し、EOF(一般に -1)を返します。

落とし穴  EOF検出のため、返却値を代入する変数の型は char, signed char, unsigned char であってはなりません。これは入力される文字の値は unsigned char型の範囲(一般に 0~255)ですが、EOFマクロは負の汎整数型定数(一般に -1)であるからです。



 プログラム例   

文字入力の確認
ファイルから1文字ずつ入力して内容を表示するプログラムです。
// fgetc1.c

#include <stdio.h> // FILE,EOF,fgetc,fopen,putchar
#include <stdlib.h> // EXIT_SUCCESS


int main(int argc,char *argv[])
{
  FILE *sget; // 入力ストリーム Stream GET

  sget=fopen(argv[1],"r");

  while(1)
  {
    int c=fgetc(sget); // 文字 Character
    //[解説]EOF検出のためcharは不可
    if(c==EOF)break; // ファイル終了
    printf("|%c",c);
  } // while

  return EXIT_SUCCESS;
} // main
実行結果
>>type fgetc.tes⏎  …… ファイルの内容確認
abcdefg
123

>>fgetc1 fgetc.tes⏎
|a|b|c|d|e|f|g|
|1|2|3|

>>■
fgetc1.c の別な書き方。
// fgetc2.c

#include <stdio.h> // FILE,EOF,fgetc,fopen,putchar
#include <stdlib.h> // EXIT_SUCCESS


int main(int argc,char *argv[])
{
  int c; // EOF検出のためcharは不可
  FILE *sget; // 入力ストリーム Stream GET

  sget=fopen(argv[1],"r");

  while((c=fgetc(sget))!=EOF)printf("|%c",c);

  return EXIT_SUCCESS;
} // main
実行結果  fgetc1.c と同じ。
>>type fgetc.tes⏎  …… ファイルの内容確認
abcdefg
123

>>fgetc1 fgetc.tes⏎
|a|b|c|d|e|f|g|
|1|2|3|

>>■
バイナリ・ファイルの入力
// fgetc3.c

#include <stdio.h> // FILE,fgetc,fputc
#include <stdlib.h> // EXIT_SUCCESS
#include <limits.h> // UCHAR_MAX


int main(void)
{
  int i;
  FILE *stream;

  stream=fopen("test","wb"); // バイナリ・ファイル書出モード
  for(i=0;i<=UCHAR_MAX;i++)
    printf("%3d ",fputc(i,stream));
  printf("\n");

  stream=fopen("test","rb"); // バイナリ・ファイル読込モード
  for(i=0;i<=UCHAR_MAX;i++)
    printf("%3d ",fgetc(stream));
  printf("\n");

  return EXIT_SUCCESS;
} // main
実行結果  0~255 の数値を 2回表示します。
  0   1   2   3   4   5   6   7   8   9  10  11
 12  13  14  15  16  17  18  19  20  21  22  23
 24  25  26  27  28  29  30  31  32  33  34  35
 36  37  38  39  40  41  42  43  44  45  46  47
 48  49  50  51  52  53  54  55  56  57  58  59
 60  61  62  63  64  65  66  67  68  69  70  71
 72  73  74  75  76  77  78  79  80  81  82  83
 84  85  86  87  88  89  90  91  92  93  94  95
 96  97  98  99 100 101 102 103 104 105 106 107
108 109 110 111 112 113 114 115 116 117 118 119
120 121 122 123 124 125 126 127 128 129 130 131
132 133 134 135 136 137 138 139 140 141 142 143
144 145 146 147 148 149 150 151 152 153 154 155
156 157 158 159 160 161 162 163 164 165 166 167
168 169 170 171 172 173 174 175 176 177 178 179
180 181 182 183 184 185 186 187 188 189 190 191
192 193 194 195 196 197 198 199 200 201 202 203
204 205 206 207 208 209 210 211 212 213 214 215
216 217 218 219 220 221 222 223 224 225 226 227
228 229 230 231 232 233 234 235 236 237 238 239
240 241 242 243 244 245 246 247 248 249 250 251
252 253 254 255
  0   1   2   3   4   5   6   7   8   9  10  11
 12  13  14  15  16  17  18  19  20  21  22  23
 24  25  26  27  28  29  30  31  32  33  34  35
 36  37  38  39  40  41  42  43  44  45  46  47
 48  49  50  51  52  53  54  55  56  57  58  59
 60  61  62  63  64  65  66  67  68  69  70  71
 72  73  74  75  76  77  78  79  80  81  82  83
 84  85  86  87  88  89  90  91  92  93  94  95
 96  97  98  99 100 101 102 103 104 105 106 107
108 109 110 111 112 113 114 115 116 117 118 119
120 121 122 123 124 125 126 127 128 129 130 131
132 133 134 135 136 137 138 139 140 141 142 143
144 145 146 147 148 149 150 151 152 153 154 155
156 157 158 159 160 161 162 163 164 165 166 167
168 169 170 171 172 173 174 175 176 177 178 179
180 181 182 183 184 185 186 187 188 189 190 191
192 193 194 195 196 197 198 199 200 201 202 203
204 205 206 207 208 209 210 211 212 213 214 215
216 217 218 219 220 221 222 223 224 225 226 227
228 229 230 231 232 233 234 235 236 237 238 239
240 241 242 243 244 245 246 247 248 249 250 251
252 253 254 255





◆リンクは、ご自由にお張りください。

Copyright © 1988-2017 Hirabayashi Masahide  プライバシーポリシー