std::basic_ostream<CharT,Traits>::write

 

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_ostream

Globale Objekte
coutwcout	cerrwcerr	clogwclog
Memberfunktionen
basic_ostream::basic_ostream
basic_ostream::~basic_ostream
basic_ostream::operator= (C++11)
Formatierte Ausgabe
basic_ostream::operator<<
Unformatierte Ausgabe
basic_ostream::put
basic_ostream::write
Positionierung
basic_ostream::tellp
basic_ostream::seekp
Sonstiges
basic_ostream::flush
basic_ostream::swap (C++11)
Member-Klassen
basic_ostream::sentry
Nicht-Member-Funktionen
operator<<(std::basic_ostream)
print(std::ostream) (C++23)
println(std::ostream) (C++23)
vprint_unicode(std::ostream) (C++23)
vprint_nonunicode(std::ostream) (C++23)

 

basic_ostream& write( const char_type* s, std::streamsize count );

Verhält sich wie eine UnformattedOutputFunction. Nach der Konstruktion und Überprüfung des Sentry-Objekts werden die Zeichen von aufeinanderfolgenden Positionen im Zeichenarray ausgegeben, auf dessen erstes Element von s verwiesen wird. Zeichen werden in die Ausgabesequenz eingefügt, bis eines der folgenden Ereignisse eintritt:

• genau count Zeichen werden eingefügt
• das Einfügen in die Ausgabesequenz schlägt fehl (in diesem Fall wird setstate(badbit) aufgerufen).

Parameter

s	-	Zeiger auf die zu schreibende Zeichenkette
zählt	-	Anzahl der zu schreibenden Zeichen

Rückgabewert

*this

Ausnahmen

failure, wenn ein Fehler aufgetreten ist (der Fehlerstatus-Flag ist nicht goodbit) und exceptions() für diesen Zustand zum Werfen gesetzt ist.

Wenn eine interne Operation eine Ausnahme auslöst, wird diese abgefangen und badbit gesetzt. Wenn exceptions() für badbit gesetzt ist, wird die Ausnahme erneut ausgelöst.

Hinweise

Diese Funktion ist für die Typen signed char oder unsigned char nicht überladen, im Gegensatz zum formatierten operator<<.

Außerdem setzt diese Funktion im Gegensatz zu den formatierten Ausgabefunktionen im Fehlerfall nicht das failbit.

Bei Verwendung einer nicht-konvertierenden Locale (die Standard-Locale ist nicht-konvertierend) kann die Überschreibung dieser Funktion in std::basic_ofstream für Zero-Copy-Bulk-I/O optimiert sein (durch Überschreiben von std::streambuf::xsputn).

Beispiel

Diese Funktion kann zur Ausgabe von Objekt-Repräsentationen, d.h. binären Ausgaben, verwendet werden.

Führen Sie diesen Code aus

#include <iostream>
 
int main()
{
    int n = 0x41424344;
    std::cout.write(reinterpret_cast<char*>(&n), sizeof n) << '\n';
 
    char c[] = "This is sample text.";
    std::cout.write(c, 4).write("!\n", 2);
}

Mögliche Ausgabe

DCBA
This!

Siehe auch

operator<<(std::basic_ostream)	fügt Zeichendaten ein oder fügt in einen rvalue-Stream ein (function template)
einfügen	fügt ein Zeichen ein (public member function)