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。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。