ungetc

Если ch не равен EOF , помещает символ ch (интерпретируемый как unsigned char ) во входной буфер, связанный с потоком stream таким образом, что последующие операции чтения из stream будут извлекать этот символ. Внешнее устройство, связанное с потоком, не изменяется.

Операции перепозиционирования потока fseek , fsetpos и rewind отменяют эффекты ungetc .

Если ungetc вызывается более одного раза без промежуточного чтения или изменения позиции, операция может завершиться неудачей (другими словами, гарантирован буфер возврата размером 1, но любой буфер большего размера определяется реализацией). Если было выполнено несколько успешных вызовов ungetc , операции чтения извлекают возвращённые символы в порядке, обратном порядку вызовов ungetc .

Если ch равен EOF , операция завершается неудачей и поток не изменяется.

Успешный вызов ungetc сбрасывает флаг состояния конца файла feof .

Успешный вызов ungetc для бинарного потока уменьшает индикатор позиции потока на единицу (поведение не определено, если индикатор позиции потока был равен нулю).

Успешный вызов ungetc для текстового потока изменяет индикатор позиции потока неопределённым образом, но гарантирует, что после извлечения всех возвращённых символов операцией чтения, индикатор позиции потока будет равен своему значению до вызова ungetc .

Параметры

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

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

При неудаче EOF возвращается, а заданный поток остается неизменным.

Примечания

Размер буфера pushback на практике варьируется от 4k (Linux, MacOS) до всего лишь 4 (Solaris) или гарантированного минимума 1 (HPUX, AIX).

Видимый размер буфера возврата может быть больше, если возвращаемый символ равен символу, существующему в этой позиции во внешней символьной последовательности (реализация может просто уменьшить индикатор позиции чтения файла и избежать поддержания буфера возврата).

Пример

#include <ctype.h>
#include <stdio.h>
void demo_scanf(const char* fmt, FILE* s)
{
    while (*fmt != '\0')
    {
        if (*fmt == '%')
        {
            int c;
            switch (*++fmt)
            {
                case 'u':
                    while (isspace(c=getc(s))) {}
                    unsigned int num = 0;
                    while (isdigit(c))
                    {
                        num = num*10 + c-'0';
                        c = getc(s);
                    }
                    printf("%%u scanned %u\n", num);
                    ungetc(c, s);
                    break;
                case 'c':
                    c = getc(s);
                    printf("%%c scanned '%c'\n", c);
                    break;
            }
        }
        else
            ++fmt;
    }
}
int main(void)
{
    FILE* f = fopen("input.txt", "w+");
    if (f != NULL)
    {
        fputs("123x", f);
        rewind(f);
        demo_scanf("%u%c", f);
        fclose(f);
    }
    return 0;
}

%u scanned 123
%c scanned 'x'

Ссылки

Смотрите также