CKTIS / C
setvbuf — Pufferung eines Streams konfigurieren
setvbuf wählt den Puffermodus eines geöffneten Streams vor anderen Operationen aus und ermöglicht die Verwendung eines vom Aufrufer bereitgestellten Puffers.
Version: 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);Rufe setvbuf aus <stdio.h> nach dem Öffnen des Streams und vor jeder anderen Operation darauf auf; ein fehlgeschlagener Aufruf von setvbuf ist die Ausnahme.
mode: _IOFBF — vollständige Pufferung, _IOLBF — zeilenweise Pufferung, _IONBF — keine Pufferung. Der Rückgabewert 0 bedeutet Erfolg; ein Wert ungleich null bedeutet einen ungültigen Modus oder dass die Anforderung nicht erfüllt werden konnte.
Bei buf != NULL gibt size die Größe des Arrays an; die Bibliothek kann dieses Array verwenden. Lass es bis zum Schließen des Streams bestehen; sein Inhalt ist nicht festgelegt. Bei buf == NULL kann die Bibliothek size beim Anlegen eines Puffers verwenden.
Das Beispiel schließt stream, bevor das lokale buffer nicht mehr existiert. Den Block ohne Schließen des Streams zu verlassen, würde undefiniertes Verhalten verursachen.
Beispiele
#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;
}
Ergebnis
OK
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.