Namespaces
Variants

putchar

From cppreference.net
< c ‎ | io
ヘッダーで定義 <stdio.h>
int putchar ( int ch ) ;

文字 ch stdout に書き込みます。内部的には、文字は書き込まれる直前に unsigned char に変換されます。

putc ( ch, stdout ) と同等です。

目次

パラメータ

ch - 書き込む文字

戻り値

成功時、書き込まれた文字を返します。

失敗時には EOF を返し、 error インジケータ( ferror() 参照)を stdout に設定します。

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);
    // Test whether EOF was reached.
    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 return value is not equal to the argument
    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関数 (p: 299)
  • C89/C90標準 (ISO/IEC 9899:1990):
  • 4.9.7.9 putchar関数

関連項目

ファイルストリームに文字を書き込む
(関数)