fputwc, putwc

来自cppreference.com
< c‎ | io
 
 
文件输入/输出
类型与对象
函数
文件访问
直接输入/输出
无格式输入/输出
(C95)(C95)
(C95)
fputwcputwc
(C95)(C95)
(C95)
(C95)
有格式输入
 
在标头 <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() )。

若出现编码错误,则另外设置 errnoEILSEQ

示例

#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)
将一个宽字符串写入文件流
(函数)
从文件流获取一个宽字符
(函数)