C语言fprintf函数详解：”魔法打印机（升级版）”

大家好，欢迎来到IT知识分享网。

️ 一句话理解 fprintf

「将数据按‘魔法咒语’（格式字符串）格式化，并输出到任意文件‘打印机’（如文件、屏幕、网络流）！」

函数原型

#include <stdio.h> int fprintf(FILE *stream, const char *format, ...);

入口参数

返回参数

核心功能图解

FILE *打印机 = fopen("log.txt", "w"); fprintf(打印机, "用户 %s 登录次数：%d", "Alice", 5); → 文件内容：用户 Alice 登录次数：5

代码实例：多场景应用

场景1：写入文本文件（日志记录）

#include <stdio.h> int main() { FILE *log_file = fopen("system.log", "a"); // 追加模式 if (!log_file) { perror(" 日志文件打开失败"); return 1; } const char *user = "Bob"; int login_count = 3; // 将日志写入文件 int chars_written = fprintf(log_file, "[LOG] %s 第%d次登录\n", user, login_count); if (chars_written < 0) { printf("⚠️ 日志写入失败\n"); } else { printf("成功写入 %d 个字符到日志\n", chars_written); } fclose(log_file); return 0; }

场景2：输出到标准错误流（错误处理）

#include <stdio.h> #include <errno.h> int main() { FILE *file = fopen("non_existent.txt", "r"); if (!file) { // 将错误信息输出到stderr（通常为红色显示） fprintf(stderr, " 错误代码 %d: 文件打开失败\n", errno); return errno; } fclose(file); return 0; }

场景3：同时输出到文件和屏幕

#include <stdio.h> int main() { FILE *file = fopen("output.txt", "w"); if (!file) return 1; const char *msg = "同时写入文件和屏幕！"; // 输出到文件 fprintf(file, "%s\n", msg); // 输出到屏幕（stdout是默认的标准输出流） fprintf(stdout, "%s\n", msg); fclose(file); return 0; }

技术细节剖析

1.文件指针的魔法力量

2.与 printf 的隐藏关系

printf("Hello"); // 等价于 fprintf(stdout, "Hello");

3.动态格式化技巧

// 动态控制浮点数精度 int precision = 3; fprintf(file, "温度: %.*f°C\n", precision, 25.5678); // 输出：温度: 25.568°C

⚠️ 魔法反噬（常见错误）

1.未打开文件时使用

FILE *file = NULL; fprintf(file, "Test"); // 程序崩溃！

2.文件打开模式错误

FILE *file = fopen("data.txt", "r"); // 只读模式 fprintf(file, "写入数据"); // ❌ 写入失败，返回EOF

3.缓冲区未刷新

fprintf(file, "关键数据"); // 若程序崩溃，数据可能仍在缓冲区未写入文件！ fflush(file); // 确保立即写入

️ 安全用法进阶

检查返回值

int result = fprintf(file, "数据内容"); if (result < 0) { perror("写入失败"); clearerr(file); // 清除错误标志 }

格式化字符串截断（防溢出）

char buf[10]; // 安全写法：限制写入长度 snprintf(buf, sizeof(buf), "%s", "这是一段超长文本"); fprintf(file, "%s", buf);

对比家族函数

总结

• 核心功能：将格式化数据输出到任意文件流
• 必用场景：日志系统、错误报告、多目标输出
• 类比记忆：就像一台可以切换出口的魔法打印机，fprintf 是程序员控制数据流向的「多通道输出控制器」