C 库函数 - snprintf()

头文件 <stdio.h>

描述

snprintf() 是一个 C 语言标准库函数，用于格式化输出字符串，并将结果写入到指定的缓冲区。与 sprintf() 不同的是，snprintf() 会限制输出的字符数，避免缓冲区溢出。

C 库函数 int snprintf(char *str, size_t size, const char *format, …) 将可变参数 (…) 按照 format 格式化成字符串，并将字符串复制到 str 中，size 为要写入的字符的最大数目，超过 size 会被截断，最多写入 size-1 个字符。

与 sprintf() 函数不同的是，snprintf() 函数提供了一个参数 size，可以防止缓冲区溢出。如果格式化后的字符串长度超过了 size-1，则 snprintf() 只会写入 size-1 个字符，并在字符串的末尾添加一个空字符（\0）以表示字符串的结束。

声明

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

参数

• str：目标字符串，用于存储格式化后的字符串的字符数组的指针。
• size：字符数组的大小。
• format：格式化字符串。
• **…**：可变参数，根据 format 中的格式化指令进行格式化。

返回值

snprintf() 函数的返回值是输出到 str 缓冲区中的字符数，不包括字符串结尾的空字符 \0。如果 snprintf() 输出的字符数超过了 size 参数指定的缓冲区大小，则输出的结果会被截断，只有 size - 1 个字符被写入缓冲区，最后一个字符为字符串结尾的空字符 \0。

需要注意的是，snprintf() 函数返回的字符数并不包括字符串结尾的空字符 \0，因此如果需要将输出结果作为一个字符串使用，则需要在缓冲区的末尾添加一个空字符 \0。

示例

#include <stdio.h>

int main() {
    char buffer[50];
    int n;

    n = snprintf(buffer, sizeof(buffer), "Hello, %s!", "World");

    if (n >= 0 && n < sizeof(buffer)) {
        printf("Formatted string: %s\n", buffer);
    } else {
        printf("Buffer size is too small. Required size: %d\n", n + 1);
    }

    return 0;
}
C

在这个示例中，snprintf() 将格式化后的字符串写入 buffer 中，并确保不会超过缓冲区的大小。