std::basic_streambuf<CharT,Traits>::sputn, std::basic_streambuf<CharT,Traits>::xsputn

 

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

 

std::streamsize sputn( const char_type* s, std::streamsize count );	(1)
protected: virtual std::streamsize xsputn( const char_type* s, std::streamsize count );	(2)

1) Ruft xsputn(s, count) der am weitesten abgeleiteten Klasse auf.

2) Schreibt count Zeichen aus dem Zeichen-Array, dessen erstes Element von s gezeigt wird, in die Ausgabesequenz. Die Zeichen werden geschrieben, als ob durch wiederholte Aufrufe von sputc(). Das Schreiben stoppt, wenn entweder count Zeichen geschrieben wurden oder ein Aufruf von sputc() Traits::eof() zurückgeben würde.

Wenn der Ausgabebereich voll ist (pptr() = epptr()), ist es nicht spezifiziert, ob overflow() tatsächlich aufgerufen wird oder dessen Wirkung auf andere Weise erzielt wird.

Parameter

(keine)

Rückgabewert

Die Anzahl der erfolgreich geschriebenen Zeichen.

Hinweise

"auf andere Weise erzielt" erlaubt Massen-I/O ohne Zwischenpufferung: das ist, wie std::ofstream::write() in manchen Implementierungen einfach den Zeiger an den geeigneten Systemaufruf weitergibt.

Beispiel

Führen Sie diesen Code aus

#include <iostream>
#include <sstream>
 
int main()
{
    std::ostringstream s1;
    std::streamsize sz = s1.rdbuf()->sputn("This is a test", 14);
    s1 << '\n';
    std::cout << "The call to sputn() returned " << sz << '\n'
              << "The output sequence contains " << s1.str();
 
    std::istringstream s2;
    sz = s2.rdbuf()->sputn("This is a test", 14);
    std::cout << "The call to sputn() on an input stream returned " << sz << '\n';
}

Ausgabe

The call to sputn() returned 14
The output sequence contains This is a test
The call to sputn() on an input stream returned 0

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 565	C++98	xsputn() rief immer overflow() auf, wenn pptr() = epptr()	es muss nicht tatsächlich aufgerufen werden

Siehe auch

sgetn

ruft xsgetn() auf (public member function)