getchar

int getchar( void );

Считывает следующий символ из stdin.

Эквивалентно getc(stdin).

Параметры

(нет)

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

Полученный символ при успехе или EOF при ошибке.

Если ошибка вызвана концом файла, дополнительно устанавливает индикатор eof (см. feof()) в stdin. Если ошибка вызвана другой ошибкой, устанавливает индикатор error (см. ferror()) в stdin.

Пример

#include <stdio.h>
#include <stdlib.h>
 
int main(void)
{
    for (int ch; (ch = getchar()) != EOF;) // read/print "abcde" from stdin
        printf("%c", ch);
 
    // Test reason for reaching EOF.
    if (feof(stdin)) // if failure caused by end-of-file condition
        puts("End of file reached");
    else if (ferror(stdin)) // if failure caused by some other error
    {
        perror("getchar()");
        fprintf(stderr, "getchar() failed in file %s at line # %d\n",
                __FILE__, __LINE__ - 9);
        exit(EXIT_FAILURE);
    }
 
    return EXIT_SUCCESS;
}

abcde
End of file reached

Ссылки

• Стандарт C23 (ISO/IEC 9899:2023):
• 7.21.7.6 Функция getchar (стр.: TBD)
• Стандарт C17 (ISO/IEC 9899:2018):
• 7.21.7.6 Функция getchar (стр.: TBD)
• Стандарт C11 (ISO/IEC 9899:2011):
• 7.21.7.6 Функция getchar (стр.: 332)
• Стандарт C99 (ISO/IEC 9899:1999):
• 7.19.7.6 Функция getchar (стр.: 298)
• Стандарт C89/C90 (ISO/IEC 9899:1990):
• 4.9.7.6 Функция getchar

См. также