std::basic_filebuf<CharT,Traits>::setbuf

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Ein-/Ausgabe-Bibliothek

I/O-Manipulatoren

Print-Funktionen (C++23)

C-Style I/O

Puffer

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

Streams

Abstraktionen

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

Datei-I/O

basic_ifstream

basic_ofstream

basic_fstream

String-I/O

basic_istringstream

basic_ostringstream

basic_stringstream

Array-I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

Synchronisierte Ausgabe

basic_osyncstream (C++20)

Typen

streamoff

streamsize

fpos

Fehlerkategorie-Schnittstelle

iostream_category (C++11)

io_errc (C++11)

 

std::basic_filebuf

Öffentliche Memberfunktionen

basic_filebuf::basic_filebuf

basic_filebuf::~basic_filebuf

basic_filebuf::operator= (C++11)

basic_filebuf::swap (C++11)

basic_filebuf::native_handle (C++26)

basic_filebuf::is_open

basic_filebuf::open

basic_filebuf::close

Geschützte Memberfunktionen

basic_filebuf::showmanyc

basic_filebuf::underflow

basic_filebuf::uflow

basic_filebuf::pbackfail

basic_filebuf::overflow

basic_filebuf::setbuf

basic_filebuf::seekoff

basic_filebuf::seekpos

basic_filebuf::sync

basic_filebuf::imbue

Nicht-Member-Funktionen

swap(std::basic_filebuf) (C++11)

 

protected: virtual std::basic_streambuf<CharT, Traits>* setbuf( char_type* s, std::streamsize n )

Wenn s ein Nullzeiger ist und n Null ist, wird der Dateipuffer für die Ausgabe ungepuffert, was bedeutet, dass pbase() und pptr() Null sind und jede Ausgabe sofort an die Datei gesendet wird.

Andernfalls ersetzt ein Aufruf von setbuf() den internen Puffer (die gesteuerte Zeichensequenz) durch das vom Benutzer bereitgestellte Zeichenarray, dessen erstes Element von s gezeigt wird, und erlaubt diesem std::basic_filebuf-Objekt, bis zu n Bytes in diesem Array für das Puffern zu verwenden.

Diese Funktion ist geschützt virtuell und darf nur über pubsetbuf() oder aus Memberfunktionen einer benutzerdefinierten Klasse, die von std::basic_filebuf abgeleitet ist, aufgerufen werden.

Parameter

s	-	Zeiger auf das erste CharT im vom Benutzer bereitgestellten Puffer oder Null
n	-	die Anzahl der CharT-Elemente im vom Benutzer bereitgestellten Puffer oder Null

Rückgabewert

this

Hinweise

Die Bedingungen, unter denen diese Funktion verwendet werden kann, und die Art und Weise, wie der bereitgestellte Puffer verwendet wird, sind implementierungsabhängig.

• GCC 4.6 libstdc++

setbuf() darf nur aufgerufen werden, wenn der std::basic_filebuf nicht mit einer Datei verbunden ist (andernfalls hat er keine Auswirkung). Mit einem vom Benutzer bereitgestellten Puffer werden beim Lesen aus der Datei jeweils n-1 Bytes gelesen.

• Clang++3.0 libc++

setbuf() kann nach dem Öffnen der Datei, aber vor jeglicher I/O aufgerufen werden (kann andernfalls abstürzen). Mit einem vom Benutzer bereitgestellten Puffer werden beim Lesen aus der Datei die größten Vielfachen von 4096 gelesen, die in den Puffer passen.

• Visual Studio 2010

setbuf() kann jederzeit aufgerufen werden, auch nachdem bereits I/O stattgefunden hat. Der aktuelle Inhalt des Puffers geht verloren, falls vorhanden.

Der Standard definiert kein Verhalten für diese Funktion, außer dass setbuf(0, 0), aufgerufen vor jeglicher I/O, dazu verpflichtet ist, die Ausgabe ungepuffert einzustellen.

Beispiel

Stellt einen 10-KB-Puffer zum Lesen bereit. Unter Linux kann das Hilfsprogramm strace verwendet werden, um die tatsächlich gelesene Byteanzahl zu beobachten.

Führen Sie diesen Code aus

#include <fstream>
#include <iostream>
#include <string>
 
int main()
{
    int cnt = 0;
    std::ifstream file;
    char buf[10241];
 
    file.rdbuf()->pubsetbuf(buf, sizeof buf);
    file.open("/usr/share/dict/words");
 
    for (std::string line; getline(file, line);)
        ++cnt;
    std::cout << cnt << '\n';
}

Mögliche Ausgabe

356010

Fehlerberichte

Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR	angewendet auf	Verhalten wie veröffentlicht	Korrigiertes Verhalten
LWG 173	C++98	Der Typ von n wurde fälschlicherweise als int angegeben	korrigiert zu std::streamsize

Siehe auch

pubsetbuf	ruft setbuf() auf (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
setvbuf	setzt den Puffer und seine Größe für einen Dateistream (function)