C语言 putwc用法及代码示例

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

用法:

wint_t putwc (wchar_t wc, FILE* stream);

写宽字符流

写宽字wc到流并前进位置指示器。

由于外部文件中的宽字符由多字节字符表示，因此该函数可能涉及将多个字节写入文件，就像wcrtomb被要求翻译wc与流的内部mbstate_t目的。

如果宽字符不能使用多字节编码表示，则该函数返回WEOF和集EILSEQ作为...的价值errno。

如果发生写入错误，该函数将返回WEOF并设置错误指示对于流(ferror)。

putwc和fputwc是等效的，除了putwc在某些库中可能被实现为宏。看putwchar对于直接写入的类似函数stdout。

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

参数

wc: 要写的宽字符。
stream: 指向一个指针FILE标识输出流的对象。
信息流尚未定向，或者wide-oriented(流上的第一个I /O操作确定它是否是字节-或者宽的-面向，请参阅fwide)。

返回值

成功后，将返回写入的字符(wc提升为类型值wint_t)。
返回类型为wint_t适应特殊价值WEOF，指示失败：
如果宽字符不能解释为有效的多字节字符，则该函数返回WEOF和集errno至EILSEQ。
如果发生写入错误，该函数还会返回WEOF和错误指示(ferror)已设置。

示例

/* fputwc example */
#include <stdio.h>

int main ()
{
  FILE * pFile;
  wchar_t wc;

  pFile = fopen ("example.txt","w");
  if (pFile!=NULL) {

    for (wc = L'A' ; wc <= L'Z' ; ++wc)
      putwc ( wc , pFile );

    fclose (pFile);
  }
  return 0;
}

相关用法

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