Namespaces
Variants

fputc, putc

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

格式化输入
 
定义于头文件 <stdio.h>
int fputc( int ch, FILE* stream );
int putc( int ch, FILE* stream );

向给定的输出流 ch写入一个字符 stream。 putc() 可能实现为宏并对 stream 求值超过一次,因此对应的参数不应是带有副作用的表达式。

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

参数

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

返回值

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

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

示例

演示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);

    // Test whether EOF was reached.
    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 函数 (p: 331)
  • 7.21.7.7 putc 函数 (p: 333)
  • C99 标准 (ISO/IEC 9899:1999):
  • 7.19.7.3 fputc 函数 (p: 297)
  • 7.19.7.8 putc 函数 (p: 299)
  • C89/C90 标准 (ISO/IEC 9899:1990):
  • 4.9.7.3 fputc 函数
  • 4.9.7.8 putc 函数

参阅

向 stdout
(函数)
C++ 文档 关于 fputc, putc