setbuf

 

C

Compiler-Unterstützung

Sprache

Header

Typunterstützung

Programm-Dienstprogramme

Unterstützung für variable Funktionsargumente

Fehlerbehandlung

Dynamische Speicherverwaltung

Bibliothek für Zeichenketten

Algorithmen

Numerik

Datums- und Zeitdienstprogramme

Ein-/Ausgabeunterstützung

Lokalisierungsunterstützung

Unterstützung für Nebenläufigkeit (C11)

Technische Spezifikationen

Symbolindex

 

Datei-Ein-/Ausgabe

Typen und Objekte
stdinstdoutstderr          FILE fpos_t
Funktionen Datei-Zugriff fopenfopen_s (C11) freopenfreopen_s (C11)   fwide (C95) setbuf setvbuf fclose fflush Unformatierte Ein-/Ausgabe fgetc fgets fputc fputs getchar getsgets_s (bis C11)(C11) putchar puts ungetc fgetwcgetwc (C95)(C95) fgetws (C95) fputwcputwc (C95)(C95) fputws (C95) getwchar (C95) putwchar (C95) ungetwc (C95) Formatierte Eingabe scanffscanfsscanfscanf_sfscanf_ssscanf_s (C11)(C11)(C11) wscanffwscanfswscanfwscanf_sfwscanf_sswscanf_s (C95)(C95)(C95)(C11)(C11)(C11) vscanfvfscanfvsscanfvscanf_svfscanf_svsscanf_s (C99)(C99)(C99)(C11)(C11)(C11) vwscanfvfwscanfvswscanfvwscanf_svfwscanf_svswscanf_s (C99)(C99)(C99)(C11)(C11)(C11)	Direkte Ein-/Ausgabe fread fwrite Formatierte Ausgabe printffprintfsprintfsnprintfprintf_sfprintf_ssprintf_ssnprintf_s (C99)(C11)(C11)(C11)(C11) wprintffwprintfswprintfwprintf_sfwprintf_sswprintf_ssnwprintf_s (C95)(C95)(C95)(C11)(C11)(C11)(C11)   vprintfvfprintfvsprintfvsnprintfvprintf_svfprintf_svsprintf_svsnprintf_s (C99)(C11)(C11)(C11)(C11) vwprintfvfwprintfvswprintfvwprintf_svfwprintf_svswprintf_svsnwprintf_s (C95)(C95)(C95)(C11)(C11)(C11)(C11) Dateipositionierung ftell fgetpos fseek fsetpos rewind Fehlerbehandlung clearerr feof ferror perror Operationen auf Dateien remove tmpfiletmpfile_s (C11) rename tmpnamtmpnam_s (C11)

 

Definiert in Header <stdio.h>
void setbuf( FILE          *stream, char          *buffer );		(bis C99)
void setbuf( FILE *restrict stream, char *restrict buffer );		(seit C99)
#define BUFSIZ     /*nicht spezifiziert*/

Legt den internen Puffer für Stream-Operationen fest. Er sollte mindestens BUFSIZ Zeichen lang sein.

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

Wenn buffer null ist, ist dies äquivalent zu setvbuf(stream, NULL, _IONBF, 0), was die Pufferung deaktiviert.

Parameter

stream	-	Der zu konfigurierende Dateistream
buffer	-	Zeiger auf einen Puffer, den der Stream verwenden soll. Wenn ein Nullzeiger übergeben wird, wird die Pufferung deaktiviert.

Rückgabewert

Keiner.

Hinweise

Wenn BUFSIZ nicht die geeignete Puffergröße ist, kann setvbuf verwendet werden, um dies 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 bevor eine andere Operation (außer einem fehlgeschlagenen Aufruf von setbuf/setvbuf) ausgeführt wurde.

Ein häufiger Fehler ist das Setzen des Puffers von stdin oder stdout auf ein Array, dessen Lebensdauer vor Programmende endet.

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

Beispiel

setbuf kann verwendet werden, um die Pufferung für Streams zu deaktivieren, die eine sofortige Ausgabe erfordern.

Führen Sie diesen Code aus

#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'); 
}

Ausgabe

ab

Referenzen

• C17-Standard (ISO/IEC 9899:2018)

• 7.21.5.5 The setbuf function (S. 225)

• C11-Standard (ISO/IEC 9899:2011)

• 7.21.5.5 The setbuf function (S. 307-308)

• C99-Standard (ISO/IEC 9899:1999)

• 7.19.5.5 The setbuf function (S. 273)

• C89/C90-Standard (ISO/IEC 9899:1990)

• 4.9.5.5 The setbuf function

Siehe auch

setvbuf	setzt den Puffer und seine Größe für einen Dateistream (Funktion)
C++ Dokumentation für setbuf