C 程式設計/stdio.h/fread

fread 是一個從檔案讀取緩衝的二進位制輸入的函式。^[1] 它包含在標準 C 庫中的 stdio.h 標頭檔案中。

size_t fread (void * restrict ptr, size_t size, size_t nmemb, FILE * restrict stream)

fread 函式從名為 stream 的輸入流中複製 nmemb 個大小為 size 的資料項到 ptr 指向的陣列中。資料項是一個位元組序列（不一定是空位元組結尾），長度為 size。當讀完 nmemb 個數據項、遇到檔案結尾或發生錯誤時，fread 停止追加位元組。返回時，fread 將流中的檔案指標設定為指向已讀最後一個位元組的下一個位元組。stream 的內容保持不變。fread 函式返回實際讀取的資料項數量。如果 nmemb 為零，則不執行任何操作，函式將返回 0。