bionic (3) setbuf.3.gz

Provided by: manpages-de-dev_2.5-1_all bug

BEZEICHNUNG

       setbuf, setbuffer, setlinebuf, setvbuf - Pufferaktionen 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)):

       setbuffer(), setlinebuf():
           Seit Glibc 2.19:
               _DEFAULT_SOURCE
           Glibc 2.19 und älter:
               _BSD_SOURCE

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 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 voll gepuffert

       Mit  Ausnahme von ungepufferten Dateien sollte mit dem Argument buf ein Zeiger auf einen Puffer angegeben
       werden, der mindestens size Byte groß ist. Dieser Puffer wird anstelle des aktuellen  Puffers  verwendet.
       Wenn  für buf NULL angegeben wird, ist nur der Modus betroffen; bei der nächsten Schreib- oder Leseaktion
       wird ein neuer Puffer reserviert. Die Funktion setvbuf() darf nur dann  angewendet  werden,  nachdem  ein
       Stream geöffnet wurde und bevor irgendwelche anderen Aktionen darauf ausgeführt wurden.

       Die  anderen  drei  Funktionen  sind im Endeffekt einfache Aliase für Aufrufe von setvbuf(). Die Funktion
       setbuf() entspricht genau dem folgendem Aufruf:

           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.

       Die anderen Funktionen geben keinen Wert zurück.

ATTRIBUTE

       Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.

       ┌────────────────────────┬───────────────────────┬─────────┐
       │SchnittstelleAttributWert    │
       ├────────────────────────┼───────────────────────┼─────────┤
       │setbuf(), setbuffer(),  │ Multithread-Fähigkeit │ MT-Safe │
       │setlinebuf(), setvbuf() │                       │         │
       └────────────────────────┴───────────────────────┴─────────┘

KONFORM ZU

       Die Funktionen setbuf() und setvbuf() sind konform zu C89 und C99.

FEHLER

       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

       stdbuf(1), fclose(3), fflush(3), fopen(3), fread(3), malloc(3), printf(3), puts(3)

KOLOPHON

       Diese Seite ist Teil der Veröffentlichung  4.15  des  Projekts  Linux-man-pages.  Eine  Beschreibung  des
       Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden
       sich unter https://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

       Die deutsche Übersetzung dieser Handbuchseite wurde von Martin Eberhard Schauer <Martin.E.Schauer@gmx.de>
       erstellt.

       Diese  Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer
       bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

       Wenn Sie Fehler in der Übersetzung dieser  Handbuchseite  finden,  schicken  Sie  bitte  eine  E-Mail  an
       <debian-l10n-german@lists.debian.org>.