C 库 - vsprintf() 函数

C 库函数 vsprintf(char *str, const char *format, va_list arg) 使用传递给它的参数列表将格式化的输出发送到字符串。当需要使用在运行时动态创建的参数列表来格式化字符串时，此函数非常有用。

语法

以下是 C 库函数 vsprintf() 的语法：

int vsprintf(char *str, const char *format, va_list arg);

参数

此函数接受三个参数：

• *char str: 指向存储结果 C 字符串的缓冲区的指针。缓冲区必须足够大，以容纳结果字符串，包括空终止符。
• *const char format: 包含要写入字符串 str 的文本的 C 字符串。它可以包含可选的嵌入式格式说明符，这些说明符将被后续参数列表中指定的值替换。
• va_list arg: 表示可变参数列表的值。这通常使用 va_start 宏初始化，并应传递给 vsprintf。

返回值

该函数返回写入字符串 str 的字符总数，不包括空终止符。如果发生错误，则函数返回负值。

示例 1：简单的字符串格式化

以下代码演示了简单的字符串格式化，其中单个字符串参数被格式化为占位符 %s。

以下是 C 库 vsprintf() 函数的示例。

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

void formatString(char *buffer, const char *format, ...) {
    eva_list args;
    va_start(args, format);
    vsprintf(buffer, format, args);
    va_end(args);
}

int main() {
    char buffer[100];
    formatString(buffer, "Hello, %s!", "World");
    printf("%s\n", buffer);
    return 0;
}

输出

以上代码产生以下结果：

Hello, World!

示例 2：多种数据类型

以下代码演示了使用适当的格式说明符将多种数据类型（字符串、整数和浮点数）格式化到缓冲区中。

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

void formatString(char *buffer, const char *format, ...) {
   va_list args;
   va_start(args, format);
   vsprintf(buffer, format, args);
   va_end(args);
}

int main() {
   char buffer[100];
   formatString(buffer, "Name: %s, Age: %d, Score: %.2f", "Alice", 30, 95.5);
   printf("%s\n", buffer);
   return 0;
}

输出

执行以上代码后，我们得到以下结果：

Name: Alice, Age: 30, Score: 95.50

示例 3：处理长字符串

以下代码演示了如何处理和格式化长字符串，确保缓冲区可以容纳整个格式化字符串而不会被截断。

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

void formatString(char *buffer, const char *format, ...) {
   va_list args;
   va_start(args, format);
   vsprintf(buffer, format, args);
   va_end(args);
}

int main() {
   char buffer[200];
   const char *longString = "This is a very long string that needs to be formatted properly into the buffer.";
   formatString(buffer, "Formatted String: %s", longString);
   printf("%s\n", buffer);
   return 0;
}

输出

以上代码的输出如下：

Formatted String: This is a very long string that needs to be formatted properly into the buffer.