std::basic_stringbuf<CharT,Traits,Allocator>::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_stringbuf

Öffentliche Memberfunktionen

basic_stringbuf::basic_stringbuf

basic_stringbuf::operator= (C++11)

basic_stringbuf::swap (C++11)

basic_stringbuf::str

basic_stringbuf::get_allocator (C++20)

basic_stringbuf::view (C++20)

Geschützte Memberfunktionen

basic_stringbuf::underflow

basic_stringbuf::pbackfail

basic_stringbuf::overflow

basic_stringbuf::setbuf

basic_stringbuf::seekoff

basic_stringbuf::seekpos

Nicht-Member-Funktionen

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

Nur exposition-only Memberfunktionen

basic_stringbuf::init_buf_ptrs

 

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

Wenn s ein Nullzeiger ist und n Null ist, hat diese Funktion keine Auswirkung.

Andernfalls ist die Auswirkung implementierungsabhängig: Einige Implementierungen tun nichts, während einige Implementierungen den std::string-Member, der derzeit als Puffer verwendet wird, löschen und mit dem vom Benutzer bereitgestellten Zeichen-Array der Größe n, dessen erstes Element von s gezeigt wird, als Puffer und Ein-/Ausgabe-Zeichensequenz beginnen.

Diese Funktion ist ein protected virtual, sie kann nur über pubsetbuf() oder aus Memberfunktionen einer von std::basic_stringbuf abgeleiteten benutzerdefinierten Klasse 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

Anmerkungen

Der veraltete Stream-Puffer std::strstreambuf oder das Boost.IOStreams-Gerät boost::basic_array können verwendet werden, um die I/O-Pufferung über ein vom Benutzer bereitgestelltes Zeichen-Array auf portable Weise zu implementieren.

Beispiel

Test der setbuf-Funktionalität des stringstreams.

Führen Sie diesen Code aus

#include <iostream>
#include <sstream>
 
int main()
{
    std::ostringstream ss;
    char c[1024] = {};
    ss.rdbuf()->pubsetbuf(c, 1024);
    ss << 3.14 << '\n';
    std::cout << c << '\n';
}

Ausgabe

3.14 (on GNU g++/libstdc++ and SunPro C++/roguewave)
<nothing> (on MS Visual Studio 2010, SunPro C++/stlport4, CLang++/libc++)

Siehe auch

pubsetbuf

ruft setbuf() auf (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)