Namespaces
Variants

putchar

From cppreference.net
< c ‎ | io
定义于头文件 <stdio.h>
int putchar ( int ch ) ;

将字符 ch 写入 stdout 。在内部,该字符在写入前会被转换为 unsigned char

等价于 putc ( ch, stdout )

目录

参数

ch - 待写入的字符

返回值

成功时,返回已写入的字符。

失败时,返回 EOF 并在 stdout 上设置错误指示器(参见 ferror() )。

示例

展示带错误检查的 putchar 用法

#include <stdio.h>
#include <stdlib.h>
int main(void)
{
    int ret_code = 0;
    for (char c = 'a'; (ret_code != EOF) && (c != 'z'); c++)
        ret_code = putchar(c);
    // 测试是否到达EOF
    if (ret_code == EOF && ferror(stdout))
    {
        fprintf(stderr, "putchar() failed in file %s at line # %d\n",
                __FILE__, __LINE__ - 6);
        perror("putchar()");
        exit(EXIT_FAILURE);
    }
    putchar('\n');
    // putchar返回值不等于参数值
    int r = 0x1070;
    printf("\n0x%x\n", r);
    r = putchar(r);
    printf("\n0x%x\n", r);
}

输出:

abcdefghijklmnopqrstuvwxy
0x1070
p
0x70

参考文献

  • C23 标准 (ISO/IEC 9899:2024):
  • 7.21.7.8 putchar 函数 (p: TBD)
  • C17 标准 (ISO/IEC 9899:2018):
  • 7.21.7.8 putchar 函数 (p: TBD)
  • C11 标准 (ISO/IEC 9899:2011):
  • 7.21.7.8 putchar 函数 (p: 333)
  • C99标准(ISO/IEC 9899:1999):
  • 7.19.7.9 putchar函数(页数:299)
  • C89/C90 标准 (ISO/IEC 9899:1990):
  • 4.9.7.9 putchar 函数

参见

将字符写入文件流
(函数)
C++ 文档 关于 putchar