vsnprintf函数与snprintf

### 比较 `vsnprintf` 和 `snprintf` 函数

#### 定义与功能差异

C标准库提供了两种用于格式化字符串并将其写入缓冲区的函数：`snprintf` 和 `vsnprintf`。两者都旨在防止缓冲区溢出，通过指定最大字符数来控制输出长度。

对于 `snprintf` 而言，在给定的最大字节数内尽可能多地写入数据，并返回应写入的总字符数（不考虑大小限制）。如果实际所需空间超过提供的缓冲区，则只填充部分结果[^1]。

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

另一方面，`vsnprintf` 接受可变参数列表作为单独输入而不是嵌入到调用中。这使得它更适合于实现其他带有不同数量或类型的参数的打印例程内部使用。同样地，该方法也遵循类似的截断行为当目标数组不足以容纳整个消息时。

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

#### 参数传递方式的不同

主要区别在于最后一个参数：

- 对于 `snprintf` 来说，后续跟随的是具体要被替换进模板中的各个变量；
- 使用 `vsnprintf` 的时候则提供了一个已经初始化好的 `va_list` 类型对象，代表了一系列未命名实参的位置信息。

这种设计允许程序员先收集所有待处理的数据项至一个集合里再统一交给后者完成最终组装工作，从而提高了灵活性和重用度。

#### 返回值说明

两个版本都会报告按照所提供的格式串完全展开后的预期占用量——即使因为尺寸约束而未能全部写出这些字符；特别注意负数值意味着遇到了错误情况。

---