C 語言輸出函數家族全解析：printf、fprintf、sprintf、snprintf 及 v 系列變體

編輯：關於C語言

函數原型速查表

#include <stdio.h>
// 標準輸出流
int printf(const char *format, ...);
int vprintf(const char *format, va_list ap);

// 指定流輸出
int fprintf(FILE *stream, const char *format, ...);
int vfprintf(FILE *stream, const char *format, va_list ap);

// 字符串輸出
int sprintf(char *str, const char *format, ...);
int vsprintf(char *str, const char *format, va_list ap);

// 安全字符串輸出 (防緩衝區溢出)
int snprintf(char *str, size_t size, const char *format, ...);
int vsnprintf(char *str, size_t size, const char *format, va_list ap);

核心差異對比

函數組	輸出目標	參數機制	安全性	典型應用場景
printf / vprintf	stdout (標準輸出)	可變參數 / va_list	-	控制台日誌、調試輸出
fprintf / vfprintf	FILE *stream (文件/網絡/管道)	可變參數 / va_list	-	文件寫入、錯誤日誌(stderr)
sprintf / vsprintf	char *str (字符串緩衝區)	可變參數 / va_list	⚠️ 不安全，無長度檢查	舊代碼、確定緩衝區足夠大時
snprintf / vsnprintf	char *str, size_t size	可變參數 / va_list	✅ 安全，限制寫入長度	現代代碼標準選擇，防止緩衝區溢出

關鍵知識點深度解析

1. 返回值語義（重點掌握）

成功：返回實際寫入的字符數，不包含結尾的 '\0'。
snprintf/vsnprintf 截斷情況：若輸出內容超過 size-1，函數會截斷並寫入 '\0'，返回值為本應寫入的字符數（不含 '\0'）。若返回值 >= size，表示發生截斷。
錯誤：返回負值。

man 手冊原文解讀：
"Upon successful return, these functions return the number of characters printed (not including the trailing '\0' used to end output to strings). The functions snprintf() and vsnprintf() do not write more than size bytes (including the trailing '\0'). If the output was truncated due to this limit then the return value is the number of characters (not including the trailing '\0') which would have been written to the final string if enough space had been available. Thus, a return value of size or more means that the output was truncated."

2. v 系列函數與 va_list

vprintf 等函數接收 va_list 參數，用於實現自定義格式化輸出包裝器。例如實現一個帶時間戳的日誌函數：

void log_msg(const char *fmt, ...) {
    va_list args;
    va_start(args, fmt);
    fprintf(stderr, "[LOG] ");
    vfprintf(stderr, fmt, args); // 核心：將可變參數傳遞給 vfprintf
    fprintf(stderr, "\n");
    va_end(args);
}

3. 格式化字符串核心規格

%[flags][width][.precision][length]specifier

常用 specifier：d/i(有符號整數) u(無符號) x/X(十六進制) f/F(浮點) s(字符串) c(字符) p(指針地址) %(字面%)
length 修飾符：hh(char) h(short) l(long/double) ll(long long) L(long double) z(size_t) t(ptrdiff_t)