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

Verhält sich wie eine UnformattedOutputFunction . Nach dem Konstruieren und Prüfen des Sentry-Objekts gibt es die Zeichen aus aufeinanderfolgenden Speicherstellen im Zeichenarray aus, dessen erstes Element durch s gezeigt wird. Zeichen werden in die Ausgabesequenz eingefügt, bis eines der folgenden Ereignisse eintritt:

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

Parameter

Rückgabewert

* this

Exceptions

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

Hinweise

Diese Funktion ist nicht überladen für die Typen signed char oder unsigned char , anders als der formatierte operator<< .

Im Gegensatz zu den formatierten Ausgabefunktionen setzt diese Funktion bei einem Fehler 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 werden (durch Überschreiben von std::streambuf::xsputn ).

Beispiel

#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);
}

DCBA
This!

Siehe auch