Namespaces
Variants

fputc, putc

From cppreference.net
< c ‎ | io
定义于头文件 <stdio.h>
int fputc ( int ch, FILE * stream ) ;
int putc ( int ch, FILE * stream ) ;

将字符 ch 写入到指定的输出流 stream 中。 putc ( ) 可能被实现为宏,并且会对 stream 进行多次求值,因此对应的参数不应是带有副作用的表达式。

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

目录

参数

ch - 待写入的字符
stream - 输出流

返回值

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

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

示例

展示带错误检查的 putc 用法

#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 = putc(c, stdout);
    // 测试是否到达文件末尾
    if (ret_code == EOF && ferror(stdout))
    {
        perror("putc()");
        fprintf(stderr, "putc() failed in file %s at line # %d\n",
                __FILE__, __LINE__ - 7);
        exit(EXIT_FAILURE);
    }
    putc('\n', stdout);
    return EXIT_SUCCESS;
}

输出:

abcdefghijklmnopqrstuvwxy

参考文献

  • C23 标准 (ISO/IEC 9899:2024):
  • 7.21.7.3 fputc 函数 (p: TBD)
  • 7.21.7.7 putc 函数 (p: TBD)
  • C17 标准 (ISO/IEC 9899:2018):
  • 7.21.7.3 fputc 函数 (p: TBD)
  • 7.21.7.7 putc 函数 (p: TBD)
  • C11标准(ISO/IEC 9899:2011):
  • 7.21.7.3 fputc函数(页码:331)
  • 7.21.7.7 putc函数(页码:333)
  • C99标准(ISO/IEC 9899:1999):
  • 7.19.7.3 fputc函数(页码:297)
  • 7.19.7.8 putc函数(页码:299)
  • C89/C90 标准 (ISO/IEC 9899:1990):
  • 4.9.7.3 fputc 函数
  • 4.9.7.8 putc 函数

参考

stdout 写入一个字符
(函数)
C++ 文档 关于 fputc , putc