C語言標準庫函數速查手冊：分類匯總與工程實踐指南

前言：站在巨人的肩膀上

「工欲善其事，必先利其器。」C 語言標準庫 (libc, 嵌入式常用 uClibc/musl) 是系統編程的基石。熟練掌握常用庫函數，能避免重複造輪子、減少 Bug、提升代碼可移植性。本文按頭文件分類匯總高頻函數，並給出**工程落地建議**。

一、 工程化學習與管理建議

1. 建立個人速查表：Excel/Notion 記錄 `函數名 | 參數 | 返回值 | 頭文件 | 典型用例 | 易錯點`。
2. Source Insight / VS Code 代碼片段庫：遇到一個函數，寫一個測試用例，累積成個人代碼庫。**離線環境下的救命稻草**。
3. 驗證實現差異：不同 libc (glibc, musl, MSVC CRT) 在邊界行為 (如 strncpy 不補 '\0', sprintf 返回值) 可能不同，**關鍵路徑必須實測**。
4. 權威參考：man 3 <func> (Linux), cppreference.com, 《C標準庫》 (P.J. Plauger), 《UNIX環境高級編程》(APUE) — **職業生涯第一參考書**。

二、 核心庫函數分類速查表

1. <ctype.h> 字符分類與轉換 (參數為 int, 行為受 locale 影響)

⚠️ 坑：參數必須是 unsigned char 轉 int 或 EOF，否則負值 (如 char 有符號時) 導致未定義行為。正確用法：isalpha((unsigned char)ch)。

2. <string.h> 字符串與內存操作 (核心高頻)

3. <stdio.h> 輸入輸出 (流操作)

• 格式化：printf/scanf 族。格式化字符串漏洞：printf(user_input) 致命！永遠用 printf("%s", user_input)。
• 文件操作：fopen/fclose/fread/fwrite/fseek/ftell/fflush。注意 fread 返回「成功讀取項數」而非字節數。
• 緩衝控制：setvbuf 設置行緩衝/全緩衝/無緩衝。fflush(stdout) 強制刷新 (交互式程序關鍵)。
• 臨時文件：tmpfile() (自動刪除), tmpnam() (不安全)。

4. <stdlib.h> 通用工具：內存、轉換、隨機、環境

5. <time.h> 時間處理

• time()：秒級時間戳 (time_t)。
• clock()：進程 CPU 時間 (精度 CLOCKS_PER_SEC)。
• strftime()：格式化輸出 (依 locale)。
• gmtime/localtime (非線程安全) → gmtime_r/localtime_r (POSIX) / gmtime_s/localtime_s (C11)。
• 高精度：clock_gettime(CLOCK_MONOTONIC, ...) (Linux), QueryPerformanceCounter (Win)。

6. <math.h> 數學函數 (需鏈接 -lm)

• 分類：三角、雙曲、指數對數、冪、取整、絕對值、分解、誤差函數。
• 浮點異常：errno (EDOM/ERANGE) + fenv.h (fetestexcept)。
• 精度陷阱：0.1 + 0.2 != 0.3。比較用 fabs(a-b) < epsilon。

7. <signal.h> <setjmp.h> 信號與非局部跳轉

• 僅在信號處理函數中調用 **Async-signal-safe** 函數 (如 write, _exit, sigaction)。
• setjmp/longjmp 跨函數跳轉，**不調用析構函數/清理處理器**，C++ 禁用，C 中慎用。

8. POSIX / 系統級擴展 (Unix/Linux 必備，Windows 部分不同)

• 文件 I/O：open, read, write, close, lseek, fcntl, ioctl, stat (文件描述符 fd)。
• 進程控制：fork, exec, wait, exit, kill, getpid。
• 線程：pthread_create, mutex, cond, rwlock, TLS (需 -lpthread)。
• 網絡：socket, bind, listen, accept, connect, send, recv, epoll。
• 內存映射：mmap, munmap (大文件/共享內存/零拷貝神器)。

三、 避坑指南 Top 10

1. gets() **已從 C11 移除**，永遠用 fgets()。
2. strncpy 不補 '\0'；strncat 需手動計算剩餘長度。
3. sprintf → snprintf (返回需寫入長度，檢查截斷)。
4. scanf("%s", buf) 無長度限制 → scanf("%99s", buf) 或 fgets+sscanf。
5. 內存分配**必檢查 NULL**。
6. 釋放後**置 NULL**，防雙重釋放/野指針。
7. 避免 atoi/atof，用 strtol/strtod 進行錯誤處理。
8. 多線程環境用 _r 後綴 / C11 _s 版本函數。
9. 浮點數**絕不直接 == 比較**。
10. 格式化字符串**不接受用戶輸入**。

總結

標準庫是 C 程序員的「兵器譜」。**系統性整理 + 實戰驗證 + 關注實現差異**，才能真正轉化為生產力。建議將本文作為索引，配合 `man page` / `cppreference` 深入鑽研每個高頻函數的契約與邊界。

1. 上一篇文章： C語言制表符 \t 與空格顯示差異深度解析：對齊奧秘與終端機制
2. 下一篇文章： C語言 enum 枚舉類型完整指南：三種定義方式與關鍵注意事項

關於C語言

Visual C# 定義與使用自訂屬性 (3)：套用屬性與讀取驗證

套用自訂屬性 在目標型別/方法前以方括號標記： 0 &&

printf 深度解析：轉換說明匹配、參數棧傳遞機制、返回值與類型不匹配陷阱

printf 深度解析：轉換說明匹配、參數棧傳遞機制、返回值

ZedGraph 教學（五）：BarChartSampleDemo 柱狀圖深度解析（三）

BarItem 類別架構 BarItem 繼承自 Curve

C# 自製簡易 HTTP Web Server 完整實作教學

專案架構 根目錄：C:\MyPersonalWebServ