table of contents
other languages
SETBUF(3) | Linux-Programmierhandbuch | SETBUF(3) |
BEZEICHNUNG¶
setbuf, setbuffer, setlinebuf, setvbuf - Pufferoperationen für StreamsÜBERSICHT¶
#include <stdio.h> void setbuf(FILE *stream, char *buf); void setbuffer(FILE *stream, char *buf, size_t size); void setlinebuf(FILE *stream); int setvbuf(FILE *stream, char *buf, int mode, size_t size);
Mit Glibc erforderliche Makros (siehe feature_test_macros(7)):
BESCHREIBUNG¶
Die drei verfügbaren Typen von Pufferungen sind nicht gepuffert, block-gepuffert und zeilen-gepuffert. Wenn ein Ausgabe-Stream nicht gepuffert ist, erscheinen die Informationen in der Zieldatei oder auf dem Terminal direkt nachdem sie geschrieben wurden. Wenn die Ausgabe block-gepuffert ist, werden viele Zeichen erst einmal gesammelt und dann in einem Rutsch ausgegeben. Wenn die Ausgabe zeilen-gepuffert ist, werden die Zeichen bis zu einem Zeilenvorschub-Zeichen gesammelt und erst dann ausgegeben, oder Eingaben wurden von einem beliebigen Datenstrom gelesen, der mit einem Endgerät verbunden ist (üblicherweise stdin). Die Funktion fflush(3) darf dazu verwendet werden, ein frühes Leeren des Puffers zu erzwingen (siehe auch fclose(3)). Normalerweise sind alle Dateien block-gepuffert. Wenn die erste E/A-Operation auf einer Datei durchgeführt wird, wird malloc(3) aufgerufen und ein Puffer angelegt. Wenn ein Datenstrom mit einem Terminal verbunden ist (wie bei stdout normalerweise der Fall), ist er zeilen-gepuffert. Der Standardfehlerstrom ( stderr) ist standardmäßig immer nicht gepuffert. Die Funktion setvbuf() wird genutzt, um zu jedem beliebigen Zeitpunkt die Pufferung eines geöffneten Streams zu ändern. Als Parameter wird mode wird eine der drei folgenden Konstanten verwendet:- _IONBF
- nicht gepuffert
- _IOLBF
- Zeilenpufferung
- _IOFBF
- Blockpufferung
setvbuf(stream, buf, buf ? _IOFBF : _IONBF, BUFSIZ);
Die Funktion setbuffer() ist die gleiche, bis auf die Tatsache, dass die Größe des Puffers vom Aufrufer bestimmt anstatt von der Voreinstellung BUFSIZ übernommen wird. Die Funktion setlinebuf() entspricht genau dem folgendem Aufruf:
setvbuf(stream, NULL, _IOLBF, 0);
RÜCKGABEWERT¶
Die Funktion setvbuf() gibt bei Erfolg 0 zurück. Sie gibt im Fehlerfall ( mode ist ungültig oder der Anfrage kann nicht genügt werden) ungleich Null zurück und darf dann errno setzen.KONFORM ZU¶
Die Funktionen setbuf() und setvbuf() sind konform zu C89 und C99.FEHLER¶
Die Funktionen setbuffer() und setlinebuf() sind nicht portabel auf BSD-Versionen vor 4.2BSD und sind unter Linux seit Libc 4.5.21. Auf 4.2BSD- und 4.3BSD-Systemen verwendet setbuf() immer eine suboptimale Puffergröße und sollte vermieden werden. Sie müssen sicherstellen, dass der Puffer buf zu dem Zeitpunkt, zu dem der Stream stream geschlossen wird, noch existiert, was ebenfalls bei Programmende geschieht.#include <stdio.h> int main(void) { char buf[BUFSIZ]; setbuf(stdin, buf); printf("Hallo, Welt!\n"); return 0; }
SIEHE AUCH¶
fclose(3), fflush(3), fopen(3), fread(3), malloc(3), printf(3), puts(3)KOLOPHON¶
Diese Seite ist Teil der Veröffentlichung 3.42 des Projekts Linux- man-pages. Eine Beschreibung des Projekts und Informationen, wie Fehler gemeldet werden können, finden sich unter http://www.kernel.org/doc/man-pages/.ÜBERSETZUNG¶
Die deutsche Übersetzung dieser Handbuchseite wurde von Martin Eberhard Schauer <Martin.E.Schauer@gmx.de> erstellt.3. August 2012 | Linux |