Spec-Zone.ru › C

fputc, putc

Определено в заголовке <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:2023):
    • 7.21.7.3 Функция fputc (с: TBD)
    • 7.21.7.7 Функция putc (с: TBD)
  • Стандарт C17 (ISO/IEC 9899:2018):
    • 7.21.7.3 Функция fputc (с: TBD)
    • 7.21.7.7 Функция putc (с: 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

См. также

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

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

Spec-Zone.ru

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