C++ snprintf()用法及代码示例

与 sprintf() 不同，可以写入缓冲区的最大字符数在 snprintf() 中指定。

snprintf()原型

int snprintf( char* buffer, size_t buf_size, const char* format, ... );

snprintf() 函数将 format 指向的字符串写入 buffer 。可写入的最大字符数为 (buf_size-1) 。

写入字符后，添加终止空字符。如果buf_size 等于零，则不写入任何内容并且缓冲区可能是空指针。

它在<cstdio> 头文件中定义。

参数：

• buffer：指向要写入结果的字符串缓冲区的指针。
• buf_size ：指定要写入缓冲区的最大字符数，即 buf_size-1 。
• format：指向写入文件流的空终止字符串的指针。它由字符以及以 % 开头的可选格式说明符组成。

  格式说明符被格式字符串后面的各个变量的值替换。

  格式说明符包含以下部分：

  • 前导 % 符号
  • Flags: 可选的一个或多个标志，用于修改转换行为。
    • -：左对齐字段内的结果。默认情况下它是右对齐的。
    • +：结果的符号附加到值的开头，即使是正面结果也是如此。
    • 空格：如果没有符号，则在结果的开头附加一个空格。
    • #：执行另一种形式的转换。
    • 0：用于整数和浮点数。前导零用于填充数字而不是空格。
  • Width：可选的 * 或整数值，用于指定最小宽度字段。
  • Precision ：一个可选字段，由 .后跟 * 或整数或不指定精度。
  • Length ：一个可选的长度修饰符，用于指定参数的大小。
  • Specifier: 转换格式说明符。可用的格式说明符如下：

    格式说明符	说明
    %	印刷 ％
    c	写入单个字符
    s	写入一个字符串
    d 或 i	将有符号整数转换为十进制表示
    o	将无符号整数转换为八进制表示
    X 或 x	将无符号整数转换为十六进制表示
    u	将无符号整数转换为十进制表示
    F 或 f	将浮点数转换为十进制表示
    E 或 e	将浮点数转换为十进制 index 表示法
    一个或一个	将浮点数转换为十六进制 index
    克或克	将浮点数转换为十进制或十进制 index 表示法
    n	返回到目前为止此函数调用写入的字符数。结果写入参数指向的值
    p	编写定义指针的实现定义的字符序列。

    所以格式说明符的一般格式是：%[flags][width][.precision][length]specifier

• …：指定要打印的数据的其他附加参数。它们根据格式说明符按顺序出现。

返回：

如果成功，snprintf() 函数将返回为足够大的缓冲区写入的字符数，不包括终止空字符。失败时返回负值。

当且仅当返回值为非负且小于 buf_size 时，才认为输出已完全写入。

示例：snprintf() 函数的工作原理

#include <cstdio>
#include <iostream>

using namespace std;

int main()
{
    char buffer[100];
    int retVal, buf_size = 100;
    char name[] = "Max";
    int age = 23;

    retVal = snprintf(buffer, buf_size, "Hi, I am %s and I am %d years old", name, age);
    if (retVal > 0 && retVal < buf_size)
    {
        cout << buffer << endl;
        cout << "Number of characters written = " << retVal << endl;
    }
    else
        cout << "Error writing to buffer" << endl;

    return 0;
}

运行程序时，输出将是：

Hi, I am Max and I am 23 years old
Number of characters written = 34