vsnprintf 用法

vsnprintf函数是C语言中的一个字符串格式化函数，它可以将格式化的输出写入一个字符数组中。其函数原型如下：

int vsnprintf(char *str, size_t size, const char *format, va_list ap);

参数说明：
- `str`：指向要写入的字符数组的指针。
- `size`：要写入的最大字符数，包括终止符'\0'，避免溢出。
- `format`：格式化字符串，类似于printf函数中的格式化字符串。
- `ap`：一个指向变长参数列表的指针，使用可变参数列表需要使用stdarg.h头文件中的宏定义。

vsnprintf函数的功能类似于sprintf函数，但是添加了对可变参数的支持，可以处理不定数量的参数。使用vsnprintf函数时，首先需要使用va_start宏初始化可变参数列表，然后通过va_arg宏获取每个参数的值，直到处理完所有参数后使用va_end宏结束可变参数列表。

这个函数会返回实际写入到字符数组中的字符数，不包括终止符'\0'。如果返回值等于或大于指定的size，则表示字符数组被填满或溢出。

以下是一个使用vsnprintf函数的示例：

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

int main() {
    char str[100];
    int result;
    
    result = vsnprintf(str, sizeof(str), "Hello, %s! The answer is %d.", "John", 42);
    
    printf("Output: %s\n", str);
    printf("Number of characters written: %d\n", result);
    
    return 0;
}

输出结果为：

Output: Hello, John! The answer is 42.
Number of characters written: 30

在这个示例中，vsnprintf函数将格式化的字符串写入到字符数组str中，并返回实际写入的字符数。输出结果显示写入了30个字符（包括空格和标点符号），并将结果打印出来。