std::basic_streambuf<CharT,Traits>::pubsetbuf, std::basic_streambuf<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_streambuf

Öffentliche Memberfunktionen basic_streambuf::~basic_streambuf      Lokale basic_streambuf::pubimbue basic_streambuf::getloc Positionierung basic_streambuf::pubsetbuf basic_streambuf::pubseekoff basic_streambuf::pubseekpos basic_streambuf::pubsync Get-Bereich basic_streambuf::in_avail basic_streambuf::snextc basic_streambuf::sbumpc basic_streambuf::sgetc basic_streambuf::sgetn Put-Bereich basic_streambuf::sputc basic_streambuf::sputn Putback basic_streambuf::sputbackc basic_streambuf::sungetc

Geschützte Memberfunktionen basic_streambuf::basic_streambuf basic_streambuf::operator= (C++11) basic_streambuf::swap (C++11) Lokale basic_streambuf::imbue Positionierung basic_streambuf::setbuf basic_streambuf::seekoff basic_streambuf::seekpos basic_streambuf::sync Get-Bereich basic_streambuf::showmanyc basic_streambuf::underflow basic_streambuf::uflow basic_streambuf::xsgetn basic_streambuf::ebackbasic_streambuf::gptrbasic_streambuf::egptr basic_streambuf::gbump basic_streambuf::setg Put-Bereich basic_streambuf::xsputn basic_streambuf::overflow basic_streambuf::pbasebasic_streambuf::pptrbasic_streambuf::epptr basic_streambuf::pbump basic_streambuf::setp Putback basic_streambuf::pbackfail

 

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

1) Ruft setbuf(s, n) der abgeleitetesten Klasse auf.

2) Die Basisklassenversion dieser Funktion hat keine Auswirkung. Die abgeleiteten Klassen können diese Funktion überschreiben, um die Entfernung oder den Ersatz der kontrollierten Zeichensequenz (des Puffers) durch ein vom Benutzer bereitgestelltes Array oder für jeden anderen implementierungsspezifischen Zweck zu ermöglichen.

Parameter

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

Rückgabewert

1) Der Rückgabewert von setbuf(s, n).

2) this

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[1024 * 10 + 1];
 
    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 158	C++98	das Standardverhalten von setbuf war nur spezifiziert wenn gptr() nicht null ist und nicht gleich egptr() ist	als No-Op spezifiziert für alle Fälle

Siehe auch

setbuf [virtuell]	versucht, die gesteuerte Zeichensequenz durch ein Array zu ersetzen (virtuelle geschützte Memberfunktion von std::basic_stringbuf<CharT,Traits,Allocator>)
setbuf [virtuell]	stellt einen vom Benutzer bereitgestellten Puffer bereit oder macht diesen Filebuf unbuffered (virtuelle geschützte Memberfunktion von std::basic_filebuf<CharT,Traits>)
setbuf [virtuell]	versucht, die gesteuerte Zeichensequenz durch ein Array zu ersetzen (virtuelle geschützte Memberfunktion von std::strstreambuf)
setbuf	setzt den Puffer für einen Dateistream (function)