CKTIS / C
setbuf — nastavenie vyrovnávacej pamäte prúdu
Funkcia `setbuf` z `<stdio.h>` požaduje úplné vyrovnávacie ukladanie, ak `buf` nie je `NULL`, alebo režim bez vyrovnávacej pamäte, ak je `buf` `NULL`. Implementácia môže poskytnuté pole použiť, ale nemusí. Funkcia neoznamuje, či bola požiadavka splnená.
Verzia: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdio.h>
void setbuf(FILE * restrict stream, char * restrict buf);setbuf(stream, buf) požaduje nastavenie režimu vyrovnávacieho ukladania pre otvorený prúd. Ak buf nie je NULL, požaduje úplné vyrovnávacie ukladanie (_IOFBF) s veľkosťou BUFSIZ. Implementácia môže poskytnuté pole použiť ako vyrovnávaciu pamäť, ale nemusí. Odovzdaním NULL sa požaduje režim bez vyrovnávacej pamäte (_IONBF).
Funkciu zavolajte pred akoukoľvek inou operáciou s prúdom; výnimkou je neúspešné volanie setvbuf. Ak buf nie je NULL, musí ukazovať na zapisovateľné pole s veľkosťou aspoň BUFSIZ bajtov, ktoré bude existovať až do zatvorenia prúdu. Obsah poľa nie je špecifikovaný.
Funkcia vracia void, takže nemôže oznámiť, či bola požiadavka splnená. setvbuf vracia stavový kód, umožňuje zvoliť veľkosť vyrovnávacej pamäte a podporuje vyrovnávacie ukladanie po riadkoch (_IOLBF).
Príklady
#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;
}Výsledok
Hello
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.