CKTIS / C
setvbuf — nastavenie vyrovnávacej pamäte prúdu
setvbuf vyberá režim vyrovnávacej pamäte otvoreného prúdu pred ďalšími operáciami a umožňuje použiť vlastnú vyrovnávaciu pamäť dodanú volajúcim.
Verzia: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdio.h>
int setvbuf(FILE * restrict stream, char * restrict buf, int mode, size_t size);Volanie setvbuf z <stdio.h> vykonajte po otvorení prúdu a pred akoukoľvek ďalšou operáciou s ním; výnimkou je neúspešné volanie setvbuf.
mode: _IOFBF — úplné vyrovnávanie, _IOLBF — riadkové vyrovnávanie, _IONBF — bez vyrovnávania. Návratová hodnota 0 znamená úspech; nenulová hodnota znamená neplatný režim alebo nesplnenú požiadavku.
Ak buf != NULL, size udáva veľkosť poľa; knižnica môže toto pole použiť. Ponechajte ho platné až do zatvorenia prúdu; jeho obsah nie je určený. Ak buf == NULL, knižnica môže size využiť pri alokácii vyrovnávacej pamäte.
Príklad zatvorí stream skôr, než prestane existovať lokálny buffer. Opustenie bloku bez zatvorenia prúdu by spôsobilo nedefinované správanie.
Príklady
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
char buffer[BUFSIZ];
FILE *stream = tmpfile();
if (stream == NULL)
return EXIT_FAILURE;
if (setvbuf(stream, buffer, _IOFBF, sizeof buffer) != 0) {
fclose(stream);
return EXIT_FAILURE;
}
int failed = fputs("Hello\n", stream) == EOF;
if (fclose(stream) == EOF)
failed = 1;
if (failed)
return EXIT_FAILURE;
return puts("OK") == EOF ? EXIT_FAILURE : EXIT_SUCCESS;
}
Výsledok
OK
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.