CKTIS / C
setbuf — nastavení vyrovnávací paměti proudu
Funkce `setbuf` z `<stdio.h>` požaduje plné vyrovnávací ukládání, pokud `buf` není `NULL`, nebo režim bez vyrovnávací paměti, pokud je `buf` `NULL`. Implementace může předané pole použít, ale nemusí. Funkce neoznámí, zda byl požadavek splněn.
Verze: C23; repository compiler flag, production runtime not attested
Syntaxe
#include <stdio.h>
void setbuf(FILE * restrict stream, char * restrict buf);setbuf(stream, buf) požaduje nastavení režimu vyrovnávacího ukládání pro otevřený proud. Pokud buf není NULL, požaduje plné vyrovnávací ukládání (_IOFBF) o velikosti BUFSIZ. Implementace může předané pole použít jako vyrovnávací paměť, ale nemusí. Předáním NULL se požaduje režim bez vyrovnávací paměti (_IONBF).
Funkci zavolejte před jakoukoli jinou operací s proudem; výjimkou je neúspěšné volání setvbuf. Pokud buf není NULL, musí ukazovat na zapisovatelné pole o velikosti alespoň BUFSIZ bajtů, které bude existovat až do uzavření proudu. Obsah pole není specifikován.
Funkce vrací void, takže nemůže oznámit, zda byl požadavek splněn. setvbuf vrací stavový kód, umožňuje zvolit velikost vyrovnávací paměti a podporuje vyrovnávací ukládání po řádcích (_IOLBF).
Pří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ýsledek
Hello
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.