C 風格檔案輸入/輸出

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

輸入/輸出庫

I/O 操縱器

列印函式 (C++23)

C 風格 I/O

緩衝區

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

流

抽象

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

檔案 I/O

basic_ifstream

basic_ofstream

basic_fstream

字串 I/O

basic_istringstream

basic_ostringstream

basic_stringstream

陣列 I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同步輸出

basic_osyncstream (C++20)

型別

streamoff

streamsize

fpos

錯誤類別介面

iostream_category (C++11)

io_errc (C++11)

 

C 風格 I/O

型別和物件
FILE fpos_t	stdinstdoutstderr
函式
檔案訪問 fopen freopen fclose fflush fwide setbuf setvbuf 直接輸入/輸出 fread fwrite 非格式化輸入/輸出 fgetcgetc fgets fputcputc fputs getchar gets (直到 C++14) putchar puts ungetc fgetwcgetwc fgetws fputwcputwc fputws getwchar putwchar ungetwc 格式化輸入 scanffscanfsscanf vscanfvfscanfvsscanf (C++11)(C++11)(C++11)     wscanffwscanfswscanf vwscanfvfwscanfvswscanf (C++11)(C++11)(C++11)	格式化輸出 printffprintfsprintfsnprintf (C++11) vprintfvfprintfvsprintfvsnprintf (C++11)     wprintffwprintfswprintf vwprintfvfwprintfvswprintf 檔案定位 ftell fgetpos fseek fsetpos rewind 錯誤處理 clearerr feof ferror perror 檔案操作 remove rename tmpfile tmpnam

 

C++ 標準庫的 C I/O 子集實現了 C 風格的流輸入/輸出操作。<cstdio> 標頭檔案提供通用檔案操作支援並提供窄字元和多位元組字元輸入/輸出功能，而 <cwchar> 標頭檔案提供寬字元輸入/輸出功能。

C 流由 std::FILE 型別的物件表示，只能透過 std::FILE* 型別的指標訪問和操作。每個 C 流都與一個外部物理裝置（檔案、標準輸入流、印表機、序列埠等）相關聯。

型別

定義於標頭檔案 <cstdio>
FILE	物件型別，能夠儲存控制 C I/O 流所需的所有資訊 (typedef)
fpos_t	完整的非陣列物件型別，能夠唯一指定檔案中的位置，包括其多位元組解析狀態 (typedef)

預定義標準流

定義於標頭檔案 <cstdio>
stdinstdoutstderr	與輸入流關聯的 FILE* 型別的表示式 與輸出流關聯的 FILE* 型別的表示式 與錯誤輸出流關聯的 FILE* 型別的表示式 (宏常量)

函式

定義於標頭檔案 <cstdio>
檔案訪問
fopen	開啟檔案 (函式)
freopen	用不同的名稱開啟一個現有流 (函式)
fclose	關閉檔案 (函式)
fflush	將輸出流與實際檔案同步 (函式)
fwide	在寬字元 I/O 和窄字元 I/O 之間切換檔案流 (函式)
setbuf	為檔案流設定緩衝區 (函式)
setvbuf	為檔案流設定緩衝區及其大小 (函式)
直接輸入/輸出
fread	從檔案讀取 (函式)
fwrite	寫入檔案 (函式)
非格式化輸入/輸出
位元組/多位元組字元
fgetcgetc	從檔案流中獲取一個字元 (函式)
fgets	從檔案流獲取字元字串 (函式)
fputcputc	向檔案流寫入一個字元 (函式)
fputs	將字元字串寫入檔案流 (函式)
getchar	從 stdin 讀取一個字元 (函式)
gets (C++11 起已棄用)(C++14 起移除)	從 stdin 讀取一個字串 (函式)
putchar	向 stdout 寫入一個字元 (函式)
puts	向 stdout 寫入一個字串 (函式)
ungetc	將一個字元放回檔案流中 (函式)
寬字元
fgetwcgetwc	從檔案流中獲取一個寬字元 (函式)
fgetws	從檔案流中獲取一個寬字串 (函式)
fputwcputwc	向檔案流寫入一個寬字元 (函式)
fputws	向檔案流寫入一個寬字串 (函式)
getwchar	從 stdin 讀取一個寬字元 (函式)
putwchar	向 stdout 寫入一個寬字元 (函式)
ungetwc	將一個寬字元放回檔案流中 (函式)
格式化輸入/輸出
位元組/多位元組字元
scanffscanfsscanf	從 stdin、檔案流或緩衝區讀取格式化輸入 (函式)
vscanfvfscanfvsscanf (C++11)(C++11)(C++11)	從 stdin、檔案流或緩衝區讀取格式化輸入 使用可變引數列表 (函式)
printffprintfsprintfsnprintf (C++11)	將格式化輸出列印到 stdout、檔案流或緩衝區 (函式)
vprintfvfprintfvsprintfvsnprintf (C++11)	將格式化輸出列印到 stdout、檔案流或緩衝區 使用可變引數列表 (函式)
寬字元
wscanffwscanfswscanf	從 stdin、檔案流或緩衝區讀取格式化的寬字元輸入 (函式)
vwscanfvfwscanfvswscanf (C++11)(C++11)(C++11)	從 stdin、檔案流讀取格式化的寬字元輸入 或使用可變引數列表的緩衝區 (函式)
wprintffwprintfswprintf	向 stdout、檔案流或緩衝區列印格式化的寬字元輸出 (函式)
vwprintfvfwprintfvswprintf	向 stdout、檔案流列印格式化的寬字元輸出 或使用可變引數列表的緩衝區 (函式)
檔案定位
ftell	返回當前檔案位置指示器 (函式)
fgetpos	獲取檔案位置指示器 (函式)
fseek	將檔案位置指示器移動到檔案中特定位置 (函式)
fsetpos	將檔案位置指示器移動到檔案中特定位置 (函式)
rewind	將檔案位置指示器移動到檔案開頭 (函式)
錯誤處理
clearerr	清除錯誤 (函式)
feof	檢查檔案結束 (函式)
ferror	檢查檔案錯誤 (函式)
perror	將當前錯誤的字串顯示到 stderr (函式)
檔案操作
remove	擦除檔案 (函式)
rename	重新命名檔案 (函式)
tmpfile	建立並開啟一個臨時檔案，該檔案將自動刪除 (函式)
tmpnam	返回一個唯一的檔名 (函式)

宏常量

定義於標頭檔案 <cstdio>
EOF	型別為 int 且值為負的整數常量表達式 (宏常量)
FOPEN_MAX	可同時開啟的檔案數 (宏常量)
FILENAME_MAX	容納最長支援檔名所需的 char 陣列大小 (宏常量)
BUFSIZ	std::setbuf 使用的緩衝區大小 (宏常量)
_IOFBF_IOLBF_IONBF	指示全緩衝 I/O 的 std::setbuf 引數 指示行緩衝 I/O 的 std::setbuf 引數 指示無緩衝 I/O 的 std::setbuf 引數 (宏常量)
SEEK_SETSEEK_CURSEEK_END	指示從檔案開頭定位的 std::fseek 引數 指示從當前檔案位置定位的 std::fseek 引數 指示從檔案末尾定位的 std::fseek 引數 (宏常量)
TMP_MAX	std::tmpnam 保證能生成的最大唯一檔名數量 (宏常量)
L_tmpnam	容納 std::tmpnam 結果所需的 char 陣列大小 (宏常量)

另請參閱

C 文件 檔案輸入/輸出