fgetc, fgetwc

從資料流讀取字元。

語法

int fgetc(
   FILE *stream
);
wint_t fgetwc(
   FILE *stream
);

參數

stream
FILE 結構的指標。

傳回值

fgetc 會傳回已讀取為 int 的字元，或傳回 EOF 表示錯誤或檔案結尾。 fgetwc 會傳回 ，做為 wint_t ，對應至讀取或傳回 WEOF 的寬字元，表示檔案的錯誤或結尾。 針對這兩個函式，使用 feof 或 ferror 來區分錯誤與檔案結尾條件。 如果發生讀取錯誤，表示已設定資料流錯誤指標。 如果 stream 為 NULL ， fgetc 並 fgetwc 叫用不正確參數處理常式，如參數驗證 中所述 。 如果允許繼續執行，這些函式會將 errno 設為 EINVAL，並傳回 EOF。

備註

所有這些函式都會從與 stream 相關聯檔案的目前位置讀取單一字元。 此函式接著會增加相關聯的檔案指標 (定義時) 以指向下一個字元。 如果資料流位於檔案結尾，則會設定資料流的檔案結尾指標。

fgetc 相當於 getc，但僅實作為函式，而不是函式和巨集。

fgetwc是 的寬字元版本 fgetc ;當以文字模式或二進位模式開啟時 stream ，它會以多位元組字元或寬字元的形式讀取 c 。

後 _nolock 置詞的版本完全相同，不同之處在于它們不會受到其他執行緒的干擾。

如需在文字和二進位模式中處理寬字元和多位元組字元的詳細資訊，請參閱 文字和二進位模式 中的 Unicode 資料流程 I/O。

根據預設，此函式的全域狀態會限定于應用程式。 若要變更此行為，請參閱 CRT 中的全域狀態。

泛型文字常式對應

TCHAR.H 常式	_UNICODE 和 _MBCS 未定義	_MBCS 定義	_UNICODE 定義
_fgettc	fgetc	fgetc	fgetwc

需求

函式	必要的標頭
fgetc	<stdio.h>
fgetwc	<stdio.h > 或 < wchar.h>

如需相容性詳細資訊，請參閱相容性。

範例

// crt_fgetc.c
// This program uses getc to read the first
// 80 input characters (or until the end of input)
// and place them into a string named buffer.

#include <stdio.h>
#include <stdlib.h>

int main( void )
{
   FILE *stream;
   char buffer[81];
   int  i, ch;

   // Open file to read line from:
   fopen_s( &stream, "crt_fgetc.txt", "r" );
   if( stream == NULL )
      exit( 0 );

   // Read in first 80 characters and place them in "buffer":
   ch = fgetc( stream );
   for( i=0; (i < 80 ) && ( feof( stream ) == 0 ); i++ )
   {
      buffer[i] = (char)ch;
      ch = fgetc( stream );
   }

   // Add null to end string
   buffer[i] = '\0';
   printf( "%s\n", buffer );
   fclose( stream );
}

輸入：crt_fgetc.txt

Line one.
Line two.

輸出

Line one.
Line two.

另請參閱

資料流 I/O
fputc, fputwc
getc, getwc