C语言 vswprintf用法及代码示例

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

用法:

int vswprintf (wchar_t * ws, size_t len, const wchar_t * format, va_list arg );

将格式化的数据从变量参数列表写入大小已设置的缓冲区

组成一个具有相同文本的字符串，如果格式用于wprintf，但使用由变量标识的变量参数列表中的元素arg而不是其他函数参数并将结果内容存储为C宽弦在所指向的缓冲区中ws(服用伦作为要填充的最大缓冲区容量(以宽字符表示)。

如果结果字符串长于n-1宽字符，其余字符将被丢弃而不存储。

在内部，该函数从由以下项标识的列表中检索参数：arg仿佛va_arg被用于它，因此状态arg可能会因调用而改变。

在任何情况下，arg应该已经被初始化va_start在调用之前的某个时间点，预计它将被释放va_end调用结束后的某个时间点。

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

参数

ws: 指向缓冲区的指针C宽弦被储存了。
缓冲区的大小至少应为伦宽字符。
len: 要写入缓冲区的最大宽字符数。
生成的字符串的长度最大为n-1，留出空间来容纳其他终止的null宽字符。
size_t是无符号整数类型。
format: 包含格式字符串的C宽字符串，其格式与格式在printf(参考printf有关详细信息)。
请注意，所有格式说明符的含义均与中的相同。printf;所以，%lc应该用来写宽字符(而不是%c)，也%ls应该用于宽字符串(而不是%s)。
arg: 一个值，该值标识用初始化的变量参数列表va_start。
va_list是在中定义的特殊类型<cstdarg>。

返回值

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

示例

/* vswprintf example */
#include <stdio.h>
#include <stdarg.h>
#include <wchar.h>

void PrintWide ( const wchar_t * format, ... )
{
  wchar_t buffer[256];
  va_list args;
  va_start ( args, format );
  vswprintf ( buffer, 256, format, args );
  fputws ( buffer, stdout );
  va_end ( args );
}

int main ()
{
   wchar_t str[] = L"test string has %d wide characters.\n";

   PrintWide ( str, wcslen(str) );

   return 0;
}

可能的输出：

test string has 36 wide characters.

相关用法

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