# C 標準庫 - <stdio.h> ## 簡介 **stdio .h** 頭文件定義了三個變量類型、一些宏和各種函數來執行輸入和輸出。 ## 庫變量 下面是頭文件 stdio.h 中定義的變量類型： | 變量 | 描述 | | --- | --- | | **size_t** | 這是無符號整數類型，它是 **sizeof** 關鍵字的結果。 | | **FILE** | 這是一個適合存儲文件流信息的對象類型。 | | **fpos_t** | 這是一個適合存儲文件中任何位置的對象類型。 | ## 庫宏 下面是頭文件 stdio.h 中定義的宏： | 宏 | 描述 | | --- | --- | | **NULL** | 這個宏是一個空指針常量的值。 | | **_IOFBF、_IOLBF** 和 **_IONBF** | 這些宏擴展了帶有特定值的整型常量表達式，并適用于 **setvbuf** 函數的第三個參數。 | | **BUFSIZ** | 這個宏是一個整數，該整數代表了 **setbuf** 函數使用的緩沖區大小。 | | **EOFM** | 這個宏是一個表示已經到達文件結束的負整數。 | | **FOPEN_MAX** | 這個宏是一個整數，該整數代表了系統可以同時打開的文件數量。 | | **FILENAME_MAX** | 這個宏是一個整數，該整數代表了字符數組可以存儲的文件名的最大長度。如果實現沒有任何限制，則該值應為推薦的最大值。 | | **L_tmpnam** | 這個宏是一個整數，該整數代表了字符數組可以存儲的由 tmpnam 函數創建的臨時文件名的最大長度。 | | **SEEK_CUR、SEEK_END** 和 **SEEK_SET** | 這些宏是在These macros are used in the **fseek** 函數中使用，用于在一個文件中定位不同的位置。 | | **TMP_MAX** | 這個宏是 tmpnam 函數可生成的獨特文件名的最大數量。 | | **stderr、stdin** 和 **stdout** | 這些宏是指向 FILE 類型的指針，分別對應于標準錯誤、標準輸入和標準輸出流。 | ## 庫函數 下面是頭文件 stdio.h 中定義的函數： > 為了更好地理解函數，請按照下面的序列學習這些函數，因為第一個函數中創建的文件會在后續的函數中使用到。 | 函數 | 描述 | | --- | --- | | [int fclose(FILE \*stream)](c-function-fclose.html) | 關閉流 stream。刷新所有的緩沖區。 | | [void clearerr(FILE \*stream)](c-function-clearerr.html) | 清除給定流 stream 的文件結束和錯誤標識符。 | | [int feof(FILE \*stream)](c-function-feof.html) | 測試給定流 stream 的文件結束標識符。 | | [int ferror(FILE \*stream)](c-function-ferror.html) | 測試給定流 stream 的錯誤標識符。 | | [int fflush(FILE \*stream)](c-function-fflush.html) | 刷新流 stream 的輸出緩沖區。 | | [int fgetpos(FILE \*stream, fpos_t \*pos)](c-function-fgetpos.html) | 獲取流 stream 的當前文件位置，并把它寫入到 pos。 | | [FILE \*fopen(const char \*filename, const char \*mode)](c-function-fopen.html) | 使用給定的模式 mode 打開 filename 所指向的文件。 | | [size_t fread(void \*ptr, size_t size, size_t nmemb, FILE \*stream)](c-function-fread.html) | 從給定流 stream 讀取數據到 ptr 所指向的數組中。 | | [FILE \*freopen(const char \*filename, const char \*mode, FILE \*stream)](c-function-freopen.html) | 把一個新的文件名 filename 與給定的打開的流 stream 關聯，同時關閉流中的舊文件。 | | [int fseek(FILE \*stream, long int offset, int whence)](c-function-fseek.html) | 設置流 stream 的文件位置為給定的偏移 offset，參數 _offset_ 意味著從給定的 _whence_ 位置查找的字節數。 | | [int fsetpos(FILE \*stream, const fpos_t \*pos)](c-function-fsetpos.html) | 設置給定流 stream 的文件位置為給定的位置。參數 _pos_ 是由函數 fgetpos 給定的位置。 | | [long int ftell(FILE \*stream)](c-function-ftell.html) | 返回給定流 stream 的當前文件位置。 | | [size_t fwrite(const void \*ptr, size_t size, size_t nmemb, FILE \*stream)](c-function-fwrite.html) | 把 ptr 所指向的數組中的數據寫入到給定流 stream 中。 | | [int remove(const char \*filename)](c-function-remove.html) | 刪除給定的文件名 filename，以便它不再被訪問。 | | [int rename(const char \*old_filename, const char \*new_filename)](c-function-rename.html) | 把 old_filename 所指向的文件名改為 new_filename。 | | [void rewind(FILE \*stream)](c-function-rewind.html) | 設置文件位置為給定流 stream 的文件的開頭。 | | [void setbuf(FILE \*stream, char \*buffer)](c-function-setbuf.html) | 定義流 stream 應如何緩沖。 | | [int setvbuf(FILE \*stream, char \*buffer, int mode, size_t size)](c-function-setvbuf.html) | 另一個定義流 stream 應如何緩沖的函數。 | | [FILE \*tmpfile(void)](c-function-tmpfile.html) | 以二進制更新模式(wb+)創建臨時文件。 | | [char \*tmpnam(char \*str)](c-function-tmpnam.html) | 生成并返回一個有效的臨時文件名，該文件名之前是不存在的。 | | [int fprintf(FILE \*stream, const char \*format, ...)](c-function-fprintf.html) | 發送格式化輸出到流 stream 中。 | | [int printf(const char \*format, ...)](c-function-printf.html) | 發送格式化輸出到標準輸出 stdout。 | | [int sprintf(char \*str, const char \*format, ...)](c-function-sprintf.html) | 發送格式化輸出到字符串。 | | [int vfprintf(FILE \*stream, const char \*format, va_list arg)](c-function-vfprintf.html) | 使用參數列表發送格式化輸出到流 stream 中。 | | [int vprintf(const char \*format, va_list arg)](c-function-vprintf.html) | 使用參數列表發送格式化輸出到標準輸出 stdout。 | | [int vsprintf(char \*str, const char \*format, va_list arg)](c-function-vsprintf.html) | 使用參數列表發送格式化輸出到字符串。 | | [int fscanf(FILE \*stream, const char \*format, ...)](c-function-fscanf.html) | 從流 stream 讀取格式化輸入。 | | [int scanf(const char \*format, ...)](c-function-scanf.html) | 從標準輸入 stdin 讀取格式化輸入。 | | [int sscanf(const char \*str, const char \*format, ...)](c-function-sscanf.html) | 從字符串讀取格式化輸入。 | | [int fgetc(FILE \*stream)](c-function-fgetc.html) | 從指定的流 stream 獲取下一個字符（一個無符號字符），并把位置標識符往前移動。 | | [char \*fgets(char \*str, int n, FILE \*stream)](c-function-fgets.html) | 從指定的流 stream 讀取一行，并把它存儲在 str 所指向的字符串內。當讀取 \*\*(n-1)\*\* 個字符時，或者讀取到換行符時，或者到達文件末尾時，它會停止，具體視情況而定。 | | [int fputc(int char, FILE \*stream)](c-function-fputc.html) | 把參數 char 指定的字符（一個無符號字符）寫入到指定的流 stream 中，并把位置標識符往前移動。 | | [int fputs(const char \*str, FILE \*stream)](c-function-fputs.html) | 把字符串寫入到指定的流 stream 中，但不包括空字符。 | | [int getc(FILE \*stream)](c-function-getc.html) | 從指定的流 stream 獲取下一個字符（一個無符號字符），并把位置標識符往前移動。 | | [int getchar(void)](c-function-getchar.html) | 從標準輸入 stdin 獲取一個字符（一個無符號字符）。 | | [char \*gets(char \*str)](c-function-gets.html) | 從標準輸入 stdin 讀取一行，并把它存儲在 str 所指向的字符串中。當讀取到換行符時，或者到達文件末尾時，它會停止，具體視情況而定。 | | [int putc(int char, FILE \*stream)](c-function-putc.html) | 把參數 char 指定的字符（一個無符號字符）寫入到指定的流 stream 中，并把位置標識符往前移動。 | | [int putchar(int char)](c-function-putchar.html) | 把參數 char 指定的字符（一個無符號字符）寫入到標準輸出 stdout 中。 | | [int puts(const char \*str)](c-function-puts.html) | 把一個字符串寫入到標準輸出 stdout，直到空字符，但不包括空字符。換行符會被追加到輸出中。 | | [int ungetc(int char, FILE \*stream)](c-function-ungetc.html) | 把字符 char（一個無符號字符）推入到指定的流 stream 中，以便它是下一個被讀取到的字符。 | | [void perror(const char \*str)](c-function-perror.html) | 把一個描述性錯誤消息輸出到標準錯誤 stderr。首先輸出字符串 str，后跟一個冒號，然后是一個空格。 |