c语言fprimtf

### C语言 `fprintf` 函数使用方法

#### 定义与功能
在C语言中，`fprintf()`函数用于将格式化的输出写入到一个已经打开的文件流中[^2]。此操作类似于`printf()`函数的功能，区别在于后者仅能向控制台发送信息，而前者能够把数据定向至特定文件内。

#### 函数原型
该函数的具体声明如下所示：

int fprintf(FILE *stream, const char *format [, argument, ...]);

其中参数说明为：

- `FILE* stream`: 文件指针指向欲写入的目标文件；
- `const char* format`: 字符串形式的格式化模板；
- `[argument,...]`: 可变数量的实际参数列表，对应于格式字符串中的占位符[^3]。

#### 返回值解释
成功调用后返回所写字符总数；遇到错误则返回负数表示失败情况。

#### 实际应用案例
下面给出一段简单的程序来展示如何利用`fprintf()`实现向文件追加记录日志条目的过程：

#include <stdio.h>
#include <stdlib.h>

void log_message(const char* message){
    FILE *file;
    
    file = fopen("log.txt", "a"); // 打开名为"log.txt"的文件准备附加内容
    
    if(file != NULL){        
        fprintf(file, "[%s]\n", message); // 将消息按照指定格式存入文件
        
        fclose(file);
    }else{
        perror("无法创建/访问日志文件");
        exit(EXIT_FAILURE);
    }
}

int main(){
    log_message("这是一个测试的日志项");

    return 0;
}

这段代码定义了一个辅助函数`log_message`,它接收一条要被记录的消息作为输入，并通过`fprintf()`将其保存在一个叫做`log.txt`的文本文件里。每次执行都会在同一行之后新增一行带有方括号包围的时间戳样式的记录[^1]。