一句話理解 fgets

「從文件或輸入流中，安全搬運一行‘包裹’（字符串）到指定‘集裝箱’（緩沖區），避免超載（溢出）！」

函數原型#include <stdio.h>char *fgets(char *str, int n, FILE *stream);入口參數

參數

類型

比喻解釋

str

char*

存放數據的「集裝箱」（字符數組）

n

int

集裝箱的最大容量（含結尾\0）

stream

FILE*

貨物的「傳送帶」（文件指針）

返回參數

返回值

含義

char*

成功返回 str 指針

NULL

貨物已搬完（文件尾）或搬運失敗

核心功能圖解傳送帶上的貨物：H e l l o ? W o r l d ?調用 fgets(buf, 10, file) → 第一次搬運："Hello\n\0"，第二次搬運："World\n\0" 代碼實例：安全搬運實戰 場景1：從鍵盤讀取用戶輸入（防溢出）#include <stdio.h>int main() { char name[20]; // 集裝箱容量：20字符（含\0） printf("請輸入你的名字（最多19字符）："); // 從鍵盤（stdin）安全搬運輸入 if (fgets(name, sizeof(name), stdin) != NULL) { // 去除末尾可能的換行符 name[strcspn(name, "\n")] = '\0'; printf("你好，%s！\n", name); } else { printf("輸入失敗！\n"); } return 0;}

輸入測試：

輸入：Alice?輸出：你好，Alice！ 場景2：逐行讀取文件內容#include <stdio.h>int main() { FILE *file = fopen("diary.txt", "r"); if (!file) { perror("? 日記本打不開"); return 1; } char line[100]; // 集裝箱容量：100字符 int line_num = 1; // 逐行安全搬運，直到文件尾 while (fgets(line, sizeof(line), file) != NULL) { printf("行%02d：%s", line_num, line); line_num++; } fclose(file); return 0;}

文件內容（diary.txt）：

2023-10-05 晴今天學會了fgets函數！

輸出：

行01：2023-10-05 晴行02：今天學會了fgets函數！?? 常見錯誤與注意事項1.未處理換行符char buf[10];fgets(buf, 10, stdin);printf("輸入內容：%s", buf); // 若輸入"Hello?"，輸出"Hello\n"// 正確做法：替換換行符（如場景1）2.誤用 sizeof 和 strlenchar buf[20];// 錯誤！sizeof(buf)返回20，但若buf是動態分配的指針，會出錯fgets(buf, sizeof(buf), stdin); // 正確做法（動態數組）：char *buf = malloc(20);fgets(buf, 20, stdin); // 直接寫數字3.忽略返回值檢查char buf[100];fgets(buf, 100, file); // ? 不檢查返回值，可能讀到NULL// 正確寫法：if (fgets(...)) { ... } 技術細節剖析1.與 gets 的致命區別

特性

fgets

gets（已廢棄）

安全性

? 明確指定緩沖區大小

? 可能溢出緩沖區

保留換行符

? 保留并存入緩沖區

? 丟棄換行符

推薦程度

必須使用

絕對禁止使用

2.精準的字符搬運量char buf[5];fgets(buf, 5, file); // 最多搬運4字符+1個\0輸入"Hello" → 搬運"Hell\0"（截斷剩余字符）輸入"Hi?" → 搬運"Hi\n\0" 高級技巧：實現 cat 命令#include <stdio.h>void print_file(FILE *file) { char buffer[1024]; while (fgets(buffer, sizeof(buffer), file) != NULL) { fputs(buffer, stdout); // 等效于printf("%s", buffer) }}int main(int argc, char **argv) { if (argc == 1) { // 無參數時，從stdin讀取 print_file(stdin); } else { // 有參數時，逐個打開文件 for (int i = 1; i < argc; i++) { FILE *file = fopen(argv[i], "r"); if (file) { print_file(file); fclose(file); } else { fprintf(stderr, "無法打開文件：%s\n", argv[i]); } } } return 0;} 總結表格

特性

說明

安全性

防緩沖區溢出

換行處理

保留換行符并存入緩沖區

適用場景

逐行讀取文件、安全輸入

性能

適合文本處理，不建議二進制流

總結核心功能：安全讀取字符串，防止緩沖區溢出必用場景：處理用戶輸入、逐行讀取文件、網絡數據流類比記憶：就像智能物流機器人，fgets 是程序員安全搬運字符串的「防溢出衛士」