CKTIS / C
ungetc — vrácení znaku do proudu
Funkce ungetc vrátí znak do proudu, aby jej bylo možné znovu přečíst, aniž by změnila soubor. Přenositelný kód může počítat s místem pro jeden znak.
Verze: C23; repository compiler flag, production runtime not attested
Syntaxe
#include <stdio.h>
int ungetc(int c, FILE *stream);ungetc z <stdio.h> vrátí c, převedené na unsigned char, do vstupního proudu stream. Při následujícím čtení se tento znak znovu načte; nemusí odpovídat znaku přečtenému dříve. Soubor zůstane nezměněn.
Funkce vrací vrácenou hodnotu, nebo při neúspěchu EOF. Předání hodnoty EOF způsobí neúspěch, aniž by se proud změnil. Výsledky funkce fgetc ukládejte do typu int, nikoli char.
Je zaručeno místo pro jeden znak; další vrácení mohou selhat. Znaky se načítají v opačném pořadí. Úspěšné volání ungetc zruší příznak konce souboru. Úspěšné volání fseek, fsetpos nebo rewind vrácené znaky zahodí. Tento mechanismus slouží k nahlédnutí do vstupu, nikoli k obecnému vracení přečtených dat.
Příklady
#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;
}Výsledek
X B
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.