wprintf_s

wprintf, fwprintf, swprintf, wprintf_s, fwprintf_s, swprintf_s

从给定的位置加载数据，将它们转换为宽字符串等值并将结果写入各种接收器。

1）将结果写入stdout。

2）将结果写入文件流stream。

3）如果bufsz大于零，则将结果写入宽字符串buffer。最bufsz-1宽字符后面跟着空宽字符。如果bufsz为零，则不会写入任何内容（并且buffer可能是空指针），但返回值（将写入的宽字符数）仍然会计算并返回。

4-6）与（1-3）相同，但在运行时检测到以下错误并调用当前安装的约束处理函数：

• 转换说明符%n存在于format

7）与（6）相同，只是它会截断结果以适应s所指向的数组。由于所有的边界检查功能，wprintf_s，wfprintf_s，和wsprintf_s仅保证可供如果__STDC_LIB_EXT1__由实现所定义，并且如果用户定义__STDC_WANT_LIB_EXT1__的整数常数1，包括之前<stdio.h>。

参数

返回值

1,2）如果发生错误，则成功写入宽字符数或写入负值。

3）如果编码错误发生或者如果要生成的字符数等于或大于size（包括当size为零时），则写入的宽字符的数目（不包括终止空宽字符）如果成功或负值。

4,5）如果发生错误，则成功写入宽字符数或写入负值。

6）写入的宽字符数（不包括终止空值）buffer。返回编码错误和溢出时的负值。对所有其他错误返回零。

7）的，将已经写入宽字符（不包括终止空）数量buffer已经bufsz如果发生错误，已经足够大时，或为负值。（也就是说，只有当回报是非负的且小于时，写才能成功并且完成bufsz）

笔记

虽然窄字符串提供snprintf了可以确定所需的输出缓冲区大小的可能性，但对于宽字符串没有等效（直到C11的snwprintf_s），并且为了确定缓冲区大小，程序可能需要调用swprintf，检查结果值，并重新分配一个更大的缓冲区，再次尝试直到成功。

snwprintf_s不同swprintf_s，将截断结果以适应指向的数组buffer，即使截断被大多数边界检查函数视为错误。

例

#include <locale.h>
#include <wchar.h>
 
int main(void)
{
    char narrow_str[] = "z\u00df\u6c34\U0001f34c";
                    // or "zß水?"
                    // or "\x7a\xc3\x9f\xe6\xb0\xb4\xf0\x9f\x8d\x8c";
    wchar_t warr[29]; // the expected string is 28 characters plus 1 null terminator
    setlocale(LC_ALL, "en_US.utf8"
    swprintf(warr, sizeof warr/sizeof *warr,
              L"Converted from UTF-8: '%s'", narrow_str
    wprintf(L"%ls\n", warr
}

输出：

Converted from UTF-8: 'zß水?'