ungetc()

Вернуть символ во входной поток

Прототип:

#include <stdio.h>
int ungetc( int c,
FILE *fp );

Аргументы:

c
Символ, который требуется вернуть.
fp
Поток, в который требуется вернуть символ.

Библиотека:

libc

Описание:

Функция ungetc() возвращает символ, определённый c на вход потоку, на который указывает fp. Символ будет возвращён в следующий раз, когда будет происходить чтение из потока. Возвращёный символ будет отвергнут при использовании fflush() или функций позиционирования в файле ( fseek(), fsetpos(), или rewind()) перед следующей операцией чтения.

Гарантируется возвращение только одного символа (самого последнего).

Функция ungetc() удаляет индикатор конца файла, если значение c не EOF.

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

Возвращёный символ.

Примеры:

#include <stdio.h>
#include <stdlib.h>
#include <ctype.h>
int main( void )
{
FILE *fp;
int c;
long value;
fp = fopen( "file", "r" );
value = 0;
c = fgetc( fp );
while ( isdigit( c ) )
{
value = value * 10 + c - '0';
c = fgetc( fp );
}
ungetc( c, fp ); /* put last character back */
printf( "Value=%ld\n", value );
fclose( fp );
return (EXIT_SUCCESS);
}

Классификация:

ANSI, POSIX 1003.1

Точка остановки потока
Да
Обработчик прерываний
Нет
Обработчик сигналов
Нет
В потоке
Да

Тематические ссылки:

fopen(), getc(), getc_unlocked(), ungetwc()




Предыдущий раздел: Описание API системной библиотеки