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.
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應