C语言 swprintf用法及代码示例

C语言wchar头文件(wchar.h)中swprintf函数的用法及代码示例。

用法:

int swprintf (wchar_t* ws, size_t len, const wchar_t* format, ...);

将格式化的数据写入宽字符串

用以下内容组成的宽字符串与要打印的文本相同格式用于wprintf，而不是将其打印，而是将内容存储为C宽弦在所指向的缓冲区中ws。

如果生成的宽字符串长于len-1字符，其余字符将被丢弃而不存储。

内容后面会自动附加一个终止的空字符。

之后格式参数，该函数至少需要与所需数量一样多的附加参数格式。

这是宽字符等价于snprintf(<cstdio>)。

参数

ws: 指向存储结果C宽字符串的缓冲区的指针。
缓冲区的大小至少应为n宽字符。
len: 最多可填写的宽字符数ws缓冲。
生成的字符串的长度最大为n-1，留出空间来容纳其他终止的null宽字符。
size_t是无符号整数类型。
format: 包含格式字符串的C宽字符串，其格式与格式在printf(参考printf有关详细信息)。
请注意，所有格式说明符的含义均与中的相同。printf;所以，%lc应该用来写宽字符(而不是%c)，也%ls应该用于宽字符串(而不是%s)。
... (additional arguments): 取决于格式字符串，函数可能需要一系列附加参数，每个参数都包含一个用于替换a的值格式说明符在里面格式字符串(或指向存储位置的指针，用于n)。
这些参数至少应与格式说明符。该函数将忽略其他参数。

返回值

成功后，将返回写入的字符总数。此计数不包括自动附加在字符串末尾的其他null-character。
失败时返回负数，包括何时将结果字符串写入其中ws会比n字符。

示例

/* swprintf example */
#include <stdio.h>
#include <wchar.h>

int main ()
{
  wchar_t buffer [100];
  int cx;

  cx = swprintf ( buffer, 100, L"The half of %d is %d", 80, 80/2 );

  swprintf ( buffer+cx, 100-cx-1, L", and the half of that is %d.", 80/2/2 );

  fputws ( buffer, stdout );

  return 0;
}

输出：

The half of 80 is 40, and the half of that is 20.

也可以看看

snprintf: 将格式化的输出写入大小合适的缓冲区(函数 )

wprintf: 将格式化的数据打印到标准输出(函数 )

swscanf: 从字符串中读取格式化的数据(函数 )

相关用法

注：本文由纯净天空筛选整理自C标准库大神的英文原创作品 C swprintf function。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。