CKTIS / C
setbuf — Pufferung eines Datenstroms konfigurieren
`setbuf` aus `<stdio.h>` fordert bei einem von `NULL` verschiedenen `buf` vollständige Pufferung an, bei `NULL` dagegen ungepufferten Betrieb. Die Implementierung kann das bereitgestellte Array verwenden, muss es aber nicht. Die Funktion meldet nicht, ob die Anforderung erfüllt wurde.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdio.h>
void setbuf(FILE * restrict stream, char * restrict buf);setbuf(stream, buf) fordert einen Puffermodus für einen geöffneten Datenstrom an. Ist buf nicht NULL, wird vollständige Pufferung (_IOFBF) mit der Größe BUFSIZ angefordert. Die Implementierung kann das bereitgestellte Array als Puffer verwenden, muss es aber nicht. Mit NULL wird ungepufferter Betrieb (_IONBF) angefordert.
Rufen Sie die Funktion vor jeder anderen Operation am Datenstrom auf; ein fehlgeschlagener Aufruf von setvbuf ist die Ausnahme. Ist buf nicht NULL, muss es auf ein beschreibbares Array mit mindestens BUFSIZ Bytes zeigen, das bis zum Schließen des Datenstroms bestehen bleibt. Der Inhalt des Arrays ist nicht festgelegt.
Die Funktion gibt void zurück und kann daher nicht melden, ob die Anforderung erfüllt wurde. setvbuf liefert einen Statuscode, ermöglicht die Wahl der Puffergröße und unterstützt zeilenweise Pufferung (_IOLBF).
Beispiele
#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;
}Ergebnis
Hello
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.