CKTIS / C
ungetc — vraćanje znaka u tok
ungetc vraća znak u tok kako bi se ponovno pročitao, bez izmjene datoteke. Prijenosni kod može računati na prostor za jedan znak.
Verzija: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <stdio.h>
int ungetc(int c, FILE *stream);ungetc iz <stdio.h> vraća c, pretvoren u unsigned char, u ulazni tok stream. Sljedeće čitanje dohvaća taj znak; ne mora odgovarati znaku koji je ranije pročitan. Datoteka ostaje nepromijenjena.
Funkcija vraća vraćenu vrijednost ili EOF u slučaju neuspjeha. Prosljeđivanje vrijednosti EOF uzrokuje neuspjeh bez promjene toka. Rezultate funkcije fgetc pohranjujte u int, a ne u char.
Zajamčen je prostor za jedan znak; dodatna vraćanja mogu ne uspjeti. Znakovi se dohvaćaju obrnutim redoslijedom. Uspješan poziv funkcije ungetc briše oznaku kraja datoteke. Uspješan poziv funkcije fseek, fsetpos ili rewind odbacuje vraćene znakove. Ovaj mehanizam služi za pregled ulaza unaprijed, a ne za općenito poništavanje čitanja.
Primjeri
#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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.