CKTIS / C
ungetc — vrnitev znaka v tok
ungetc vrne znak v tok, da ga je mogoče znova prebrati, ne da bi spremenil datoteko. Prenosljiva koda se lahko zanese na prostor za en znak.
Različica: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <stdio.h>
int ungetc(int c, FILE *stream);ungetc iz <stdio.h> vrne c, pretvorjen v unsigned char, v vhodni tok stream. Naslednje branje ta znak pridobi; ni nujno, da ustreza prej prebranemu znaku. Datoteka ostane nespremenjena.
Funkcija vrne vrnjeno vrednost ali ob napaki EOF. Če ji podamo EOF, klic ne uspe, tok pa ostane nespremenjen. Rezultate funkcije fgetc shranjujte v int, ne v char.
Zagotovljen je prostor za en znak; nadaljnje vrnitve lahko spodletijo. Znaki se pridobijo v obratnem vrstnem redu. Uspešen klic ungetc počisti indikator konca datoteke. Uspešen klic fseek, fsetpos ali rewind zavrže vrnjene znake. Ta mehanizem je namenjen predogledu vhoda, ne splošnemu razveljavljanju branja.
Primeri
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
FILE *stream = tmpfile();
if (stream == NULL)
return EXIT_FAILURE;
if (fputs("AB", stream) == EOF || fseek(stream, 0L, SEEK_SET) != 0) {
fclose(stream);
return EXIT_FAILURE;
}
if (fgetc(stream) != 'A' || ungetc('X', stream) == EOF) {
fclose(stream);
return EXIT_FAILURE;
}
int first = fgetc(stream);
int second = fgetc(stream);
int close_result = fclose(stream);
if (first != 'X' || second != 'B' || close_result == EOF)
return EXIT_FAILURE;
if (printf("%c %c\n", first, second) < 0)
return EXIT_FAILURE;
return EXIT_SUCCESS;
}Rezultat
X B
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.