CKTIS / C
setbuf — nastavitev medpomnjenja toka
Funkcija `setbuf` iz `<stdio.h>` zahteva polno medpomnjenje, če `buf` ni `NULL`, ali delovanje brez medpomnjenja, če je `buf` enak `NULL`. Implementacija lahko uporabi podano polje, ni pa ga dolžna uporabiti. Funkcija ne sporoči, ali je bila zahteva izpolnjena.
Različica: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <stdio.h>
void setbuf(FILE * restrict stream, char * restrict buf);Z setbuf(stream, buf) zahtevate način medpomnjenja za odprt tok. Če buf ni NULL, zahtevate polno medpomnjenje (_IOFBF) z velikostjo BUFSIZ. Implementacija lahko podano polje uporabi kot medpomnilnik, ni pa ga dolžna uporabiti. Z vrednostjo NULL zahtevate delovanje brez medpomnjenja (_IONBF).
Funkcijo pokličite pred katero koli drugo operacijo na toku; izjema je neuspešen klic funkcije setvbuf. Če buf ni NULL, mora kazati na zapisljivo polje z vsaj BUFSIZ bajti, ki obstaja do zaprtja toka. Vsebina polja ni določena.
Funkcija vrne void, zato ne more sporočiti, ali je bila zahteva izpolnjena. setvbuf vrne kodo stanja, omogoča izbiro velikosti medpomnilnika in podpira medpomnjenje po vrsticah (_IOLBF).
Primeri
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
static char buffer[BUFSIZ];
setbuf(stdout, buffer);
if (puts("Hello") == EOF) {
return EXIT_FAILURE;
}
if (fflush(stdout) == EOF) {
return EXIT_FAILURE;
}
return EXIT_SUCCESS;
}Rezultat
Hello
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.