snprintf函数

snprintf函数

snprintf 函数是 C 语言标准库中的一个函数，用于将格式化的数据写入字符串。这个函数的原型定义在 <stdio.h> 头文件中，其基本语法如下：

int snprintf(char *str, size_t size, const char *format, ...);

其中，str 是指向用于存储结果字符串的缓冲区的指针，size 是缓冲区的最大大小（以字节为单位），format 是格式字符串，与 printf 函数中的格式字符串相同，后面的 … 表示可变数量的额外参数，这些参数与格式字符串中的格式占位符相对应。

这里需要注意的是第二个参数和这个函数的返回值。

• 如果发生编码错误，snprintf 函数会返回一个负数。
• 除此之外，不论缓冲区的大小是否足够放下结果字符串，都会返回如果缓冲区足够大，应该写入的字符总数，这个返回值包括了格式化字符串中所有的字符，但不包括终止的空字符。

如果缓冲区不够大，实际写入的字符数会少于这个返回值，但函数仍然会返回完整的字符总数，以便程序员可以了解需要多大的缓冲区来容纳全部数据。

下面是一个简单的例子，演示 snprintf 函数的使用和返回值：

#include <stdio.h>

int main() {
    char buffer[50];
    int num = 123;
    int ret = snprintf(buffer, sizeof(buffer), "Number: %d", num);

    printf("Formatted string: '%s'\n", buffer);
    printf("Return value: %d\n", ret);

    return 0;
}

在这个例子中，如果 buffer 足够大，snprintf 会返回格式化字符串的长度，不包括终止的空字符。如果 buffer 太小，无法容纳全部格式化后的数据，则返回的值将会是如果 buffer 足够大，本应写入的字符总数

知道了这样的特点，我们就可以通过先调用一次snprintf来获取需要的缓冲区大小，然后将其+1之后再来进行输出结果，就像这样：

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

int main() {
    char *buffer;
    int num = 123;
    // 首先调用 snprintf 获取所需的缓冲区大小
    int needed = snprintf(NULL, 0, "Number: %d", num);
    // 根据需要的大小分配缓冲区
    buffer = malloc(needed + 1); // 加1是为了空字符
    // 现在可以安全地写入数据
    snprintf(buffer, needed + 1, "Number: %d", num);

    printf("Formatted string: '%s'\n", buffer);
    printf("Needed size: %d\n", needed);

    free(buffer);
    return 0;
}

ps：在别的地方看到有人说这个+1是平台或编译器相关的，windows不+1而linux要+1.。。。。然而实际上测试过发现都需要+1.