close

fputwc, putwc

来自cppreference.com
< c | io
 
C
 
文件输入/输出
类型与对象
        
函数
文件访问
(C11)
(C11)  
(C95)
无格式输入/输出
(C95)(C95)
(C95)
(C95)(C95)
(C95)
(C95)
(C95)
(C95)

有格式输入
(C99)(C99)(C99)(C11)(C11)(C11)
(C99)(C99)(C99)(C11)(C11)(C11)  
 
在标头 <wchar.h> 定义 
wint_t fputwc( wchar_t ch, FILE *stream );
(1) (C95 起) 
wint_t putwc( wchar_t ch, FILE *stream );
(2) (C95 起)

写宽字符 ch 到给定的输出流 stream 。 可能实现为宏并可求值 stream 多于一次。

参数

ch - 要写入的宽字符
stream - 输出流

返回值

成功时返回 ch 的副本。

失败时，返回 WEOF 并设置 stream 上的错误指示器（见 ferror() ）。

若出现编码错误，则另外设置 errno 为 EILSEQ 。

示例

运行此代码
#include <errno.h>
#include <locale.h>
#include <stdio.h>
#include <stdlib.h>
#include <wchar.h>

int main(void)
{
    setlocale(LC_ALL, "en_US.utf8");

    errno = 0;
    if (fputwc(L'🍌', stdout) == WEOF)
    {
        if (errno == EILSEQ)
            puts("Encoding error in fputwc.");
        else
            puts("I/O error in fputwc.");
        return EXIT_FAILURE;
    }
}

可能的输出： 

🍌

引用

  • C23 标准（ISO/IEC 9899:2024）：
  • 7.31.3.3 The fputwc function （第 430 页）
  • 7.31.3.8 The putwc function （第 431-432 页）
  • C17 标准（ISO/IEC 9899:2018）：
  • 7.29.3.3 The fputwc function （第 308 页）
  • 7.29.3.8 The putwc function （第 310 页）
  • C11 标准（ISO/IEC 9899:2011）：
  • 7.29.3.3 The fputwc function （第 422-423 页）
  • 7.29.3.8 The putwc function （第 424 页）
  • C99 标准（ISO/IEC 9899:1999）：
  • 7.24.3.3 The fputwc function （第 368 页）
  • 7.24.3.8 The putwc function （第 370 页）

参阅

 将一个字符写入文件流
(函数) [编辑]
(C95)
 将一个宽字符串写入文件流
(函数) [编辑]
(C95)
 从文件流获取一个宽字符
(函数) [编辑]
fputwc 的 C++ 文档