Spec-Zone.ru › C

putchar

Определено в заголовке <stdio.h>
int putchar( int ch );

Записывает символ ch в stdout. Внутри символы преобразуются в unsigned char перед записью.

Эквивалентно putc(ch, stdout).

Параметры

ch - символ для записи

Возвращаемое значение

При успешном выполнении возвращает записанный символ.

При ошибке возвращает EOF и устанавливает индикатор ошибки (см. 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:2023):
    • 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

См. также

fputcputc
записывает символ в поток файла
(функция)
Документация C++ для putchar

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/c/io/putchar

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API