【C语言】vfprintf函数

vfprintf 是 C 语言中的一个函数，它是 fprintf 函数的变体，用于格式化输出到文件中。vfprintf 函数接受一个格式化字符串和一个指向可变参数列表的指针，这个列表通常是通过 va_list 类型来传递的。vfprintf 函数的主要用途是在需要处理不定数量的参数时，提供一种灵活的输出格式化方式。

原型

int vfprintf(FILE *stream, const char *format, va_list ap);

1. stream 是指向一个 FILE 对象的指针，这个对象代表了一个输出流，通常是打开的文件。
2. format 是一个格式化字符串，它包含一个或多个格式化指令，这些指令将被用来格式化输出。
3. ap 是一个指向 va_list 类型的指针，va_list 是一个用来表示可变参数列表的类型。

说明

在 vfprintf 函数中，va_list 类型用于访问参数列表中的各个参数。va_list 实际上是一个简单的类型定义，通常定义为 typedef int va_list，它只是一个整数类型的别名，用于在参数列表中进行偏移计算。

使用 vfprintf 函数时，通常需要结合 va_start、va_arg 和 va_end 宏来正确地处理可变参数列表。这些宏用于初始化 va_list 变量、获取参数列表中的下一个参数以及清理 va_list 变量，它们通常在 stdarg.h 头文件中定义。

vfprintf 函数根据 format 字符串和 ap参数列表的内容，将格式化的数据写入到 stream 指向的文件中。如果函数成功执行，它将返回写入的字符数。如果出现错误，它将返回一个负值。

这个函数通常与 <stdio.h> 和 <stdarg.h> 头文件一起使用。

示例

#include <stdio.h>  
#include <stdarg.h>  
  
int vfp(FILE *stream, char *fmt, ...) {  
    va_list args;  
    va_start(args, fmt);  
    int cnt = vfprintf(stream, fmt, args);  
    va_end(args);  
    return cnt;  
}  
  
int main() {  
    FILE *fp;  
    int inumber = 30;  
    float fnumber = 90.0;  
    char string[4] = "abc";  
    fp = tmpfile();  
    if (fp == NULL) {  
        perror("tmpfile() error");  
        return 1;  
    }  
    vfp(fp, "%d %f %s", inumber, fnumber, string);  
    if (fseek(fp, 0L, SEEK_SET) == -1) {  
        perror("fseek() error");  
        return 1;  
    }  
    if (ftell(fp) == -1L) {  
        perror("ftell() error");  
        return 1;  
    } else {  
        printf("The file position is now %ld.\n", ftell(fp));  
    }  
    return 0;  
}

ChatGPT

在C语言中，`vfprintf`函数是标准I/O库的一部分，允许程序向一个文件流写入一个格式化的字符串。它与`fprintf`函数非常相似，但提供了一种方式来接受一个`va_list`类型的可变参数列表，这使得它可以被其他函数用作写入格式化数据的底层机制。
函数的原型定义在`<stdio.h>`头文件中，如下所示：

int vfprintf(FILE *stream, const char *format, va_list ap);

参数说明：
- stream：指向`FILE`对象的指针，该对象标识了输出流。例如，可以是`stdout`，表示标准输出；或是通过`fopen`函数打开的文件。
- format：一个以 null 结尾的字符串，定义了输出的格式。格式字符串包括普通字符和格式说明符（例如`%d`，`%s`等），普通字符会被直接写入到输出流，而格式说明符则对应于`va_list`参数中的值，从而决定了如何格式化这些值。
- ap：可变参数列表，包含了一个或多个要被格式化并写入输出流的参数。
返回值：
- 返回成功写入流的字符总数。
- 如果发生错误，则返回一个负值。
请注意，使用`vfprintf`需要包含相关的头文件并且手动处理可变参数列表，通常这是通过宏`va_start`，`va_arg`和`va_end`操作`va_list`变量完成的。
以下是如何使用`vfprintf`的示例：

#include <stdio.h>
#include <stdarg.h>

void print_formatted(FILE *stream, const char *format, ...) {
    va_list args;
    va_start(args, format);
    vfprintf(stream, format, args);
    va_end(args);
}

int main() {
    FILE *fp = fopen("output.txt", "w");
    if (fp == NULL) {
        perror("Unable to open the file");
        return 1;
    }

    print_formatted(fp, "Int: %d, Double: %.2f, String: %s\n", 10, 3.14159, "Hello, World!");
    
    fclose(fp);
    return 0;
}

在这个例子中，我们定义了一个名为`print_formatted`的辅助函数，它可以接受任何数量和类型的参数，并将它们格式化输出到指定的文件流。在`main`函数中，我们创建和打开了一个文件，用`print_formatted`函数向文件中写入格式化文本，然后关闭了文件流。