setbuf

void setbuf( FILE* stream, char* buffer );

void setbuf( FILE* restrict stream, char* restrict buffer );

#define BUFSIZ  /* unspecified */

Setzt den internen Puffer, der für Stream-Operationen verwendet werden soll. Er sollte mindestens BUFSIZ Zeichen lang sein.

Falls buffer nicht null ist, äquivalent zu setvbuf(stream, buffer, _IOFBF, BUFSIZ).

Falls buffer null ist, äquivalent zu setvbuf(stream, NULL, _IONBF, 0), was die Pufferung abschaltet.

Parameter

Hinweise

Falls BUFSIZ nicht die geeignete Puffergröße ist, kann setvbuf verwendet werden, um sie zu ändern.

setvbuf sollte auch zur Fehlererkennung verwendet werden, da setbuf keinen Erfolg oder Misserfolg anzeigt.

Diese Funktion darf nur verwendet werden, nachdem stream mit einer geöffneten Datei verknüpft wurde, aber vor jeder anderen Operation (außer einem fehlgeschlagenen Aufruf von setbuf/setvbuf).

Ein häufiger Fehler ist, den Puffer von stdin oder stdout auf ein Array zu setzen, dessen Lebensdauer vor Programmende endet:

int main(void)
{
    char buf[BUFSIZ];
    setbuf(stdin, buf);
} // lifetime of buf ends, undefined behavior

Beispiel

#include <stdio.h>
#include <threads.h>

int main(void)
{
    setbuf(stdout, NULL); // unbuffered stdout
    putchar('a'); // 'a' appears immediately if stdout is unbuffered
    thrd_sleep(&(struct timespec){ .tv_sec = 1 }, NULL); // sleep 1 sec
    putchar('b');
}

ab

Referenzen

Siehe auch