一句話理解 fgets

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

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

參數(shù)

類型

比喻解釋

str

char*

存放數(shù)據(jù)的「集裝箱」（字符數(shù)組）

n

int

集裝箱的最大容量（含結(jié)尾\0）

stream

FILE*

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

返回參數(shù)

返回值

含義

char*

成功返回 str 指針

NULL

貨物已搬完（文件尾）或搬運(yùn)失敗

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

輸入測試：

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

文件內(nèi)容（diary.txt）：

2023-10-05 晴今天學(xué)會了fgets函數(shù)！

輸出：

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

特性

fgets

gets（已廢棄）

安全性

? 明確指定緩沖區(qū)大小

? 可能溢出緩沖區(qū)

保留換行符

? 保留并存入緩沖區(qū)

? 丟棄換行符

推薦程度

必須使用

絕對禁止使用

2.精準(zhǔn)的字符搬運(yùn)量char buf[5];fgets(buf, 5, file); // 最多搬運(yùn)4字符+1個\0輸入"Hello" → 搬運(yùn)"Hell\0"（截?cái)嗍Ｓ嘧址┹斎?#34;Hi?" → 搬運(yùn)"Hi\n\0" 高級技巧：實(shí)現(xiàn) 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) { // 無參數(shù)時，從stdin讀取 print_file(stdin); } else { // 有參數(shù)時，逐個打開文件 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;} 總結(jié)表格

特性

說明

安全性

防緩沖區(qū)溢出

換行處理

保留換行符并存入緩沖區(qū)

適用場景

逐行讀取文件、安全輸入

性能

適合文本處理，不建議二進(jìn)制流

總結(jié)核心功能：安全讀取字符串，防止緩沖區(qū)溢出必用場景：處理用戶輸入、逐行讀取文件、網(wǎng)絡(luò)數(shù)據(jù)流類比記憶：就像智能物流機(jī)器人，fgets 是程序員安全搬運(yùn)字符串的「防溢出衛(wèi)士」