operator<<,>>(std::basic_string)

 

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

 

Bibliothek für Zeichenketten

Klassen

basic_string

basic_string_view (C++17)

char_traits

 

std::basic_string

Memberfunktionen basic_string::basic_string basic_string::~basic_string basic_string::operator= basic_string::assign basic_string::assign_range (C++23)   basic_string::get_allocator Elementzugriff basic_string::at basic_string::operator[] basic_string::front (DR*) basic_string::back (DR*) basic_string::data basic_string::c_str basic_string::operator  basic_string_view (C++17) Iteratoren basic_string::beginbasic_string::cbegin (C++11) basic_string::endbasic_string::cend (C++11) basic_string::rbeginbasic_string::crbegin (C++11) basic_string::rendbasic_string::crend (C++11) Suche basic_string::find basic_string::rfind basic_string::find_first_of basic_string::find_first_not_of basic_string::find_last_of basic_string::find_last_not_of

Modifizierer basic_string::clear basic_string::insert basic_string::insert_range (C++23) basic_string::erase basic_string::push_back basic_string::pop_back (DR*) basic_string::append basic_string::append_range (C++23) basic_string::operator+= basic_string::replace basic_string::replace_with_range (C++23) basic_string::copy basic_string::resize basic_string::resize_and_overwrite (C++23)  basic_string::swap Kapazität basic_string::empty basic_string::sizebasic_string::length basic_string::max_size basic_string::reserve basic_string::capacity basic_string::shrink_to_fit (DR*) Operationen basic_string::compare basic_string::starts_with (C++20) basic_string::ends_with (C++20) basic_string::contains (C++23) basic_string::substr

Konstanten basic_string::npos Nicht-Member-Funktionen operator+ swap(std::basic_string) erase(std::basic_string)erase_if(std::basic_string) (C++20)(C++20) I/O operator<<operator>> getline Vergleich operator==operator!=operator<operator>operator<=operator>=operator<=> (bis C++20)(bis C++20)(bis C++20)(bis C++20)(bis C++20)(C++20) Numerische Konvertierungen stoistolstoll (C++11)(C++11)(C++11) stoulstoull (C++11)(C++11)  stofstodstold (C++11)(C++11)(C++11) to_string (C++11) to_wstring (C++11) Literale operator""s (C++14) Hilfsklassen hash<std::basic_string> (C++11) Deduction guides (C++17)

 

Definiert in Header <string>
template< class CharT, class Traits, class Allocator > std::basic_ostream<CharT, Traits>&     operator<<( std::basic_ostream<CharT, Traits>& os,                 const std::basic_string<CharT, Traits, Allocator>& str );	(1)
template< class CharT, class Traits, class Allocator > std::basic_istream<CharT, Traits>&     operator>>( std::basic_istream<CharT, Traits>& is,                 std::basic_string<CharT, Traits, Allocator>& str );	(2)

1) Verhält sich wie eine FormattedOutputFunction. Nach der Konstruktion und Prüfung des Sentry-Objekts werden die Formatierungsfüllzeichen für die Ausgabe bestimmt.

Anschließend wird jedes Zeichen aus der resultierenden Sequenz seq (dem Inhalt von str plus Füllzeichen) in den Ausgabestrom os eingefügt, als ob os.rdbuf()->sputn(seq, n) aufgerufen würde, wobei n gleich std::max(os.width(), str.size()) ist. Schließlich wird os.width(0) aufgerufen, um die Auswirkungen von std::setw abzubrechen, falls vorhanden.

Äquivalent zu return os << std::basic_string_view<CharT, Traits>(str);.

(seit C++17)

2) Verhält sich wie eine FormattedInputFunction. Nach der Konstruktion und Prüfung des Sentry-Objekts, das führende Leerzeichen überspringen kann, wird zunächst str mit str.erase() gelöscht. Dann werden Zeichen aus is gelesen und an str angehängt, als ob str.append(1, c) aufgerufen würde, bis eine der folgenden Bedingungen eintritt:

• N Zeichen werden gelesen, wobei N gleich is.width() ist, wenn is.width() > 0, andernfalls ist N gleich str.max_size(),
• die End-of-File-Bedingung im Strom is eintritt, oder
• std::isspace(c, is.getloc()) ist true für das nächste Zeichen c in is (dieses Leerzeichen verbleibt im Eingabestrom).

Wenn keine Zeichen extrahiert werden, wird std::ios::failbit für is gesetzt, was std::ios_base::failure auslösen kann.

Schließlich wird is.width(0) aufgerufen, um die Auswirkungen von std::setw abzubrechen, falls vorhanden.

Ausnahmen

1) Kann std::ios_base::failure auslösen, wenn während der Ausgabe eine Ausnahme auftritt.

2) Kann std::ios_base::failure auslösen, wenn keine Zeichen aus is extrahiert werden (z. B. der Strom ist am Ende der Datei oder besteht nur aus Leerzeichen) oder wenn während der Eingabe eine Ausnahme auftritt.

Parameter

os	-	ein Zeichen-Ausgabestrom
ist	-	ein Zeichen-Eingabestrom
str	-	der einzufügende oder zu extrahierende String

Rückgabewert

1) os

2) is

Beispiel

Führen Sie diesen Code aus

#include <iostream>
#include <sstream>
#include <string>
 
int main()
{
    std::string greeting = "Hello, whirled!";
    std::istringstream iss(greeting);
 
    std::string hello_comma, whirled, word;
 
    iss >> hello_comma;
    iss >> whirled;
 
    std::cout << greeting << '\n'
              << hello_comma << '\n' << whirled << '\n';
 
    // Reset the stream
    iss.clear();
    iss.seekg(0);
 
    while (iss >> word)
        std::cout << '+' << word << '\n';
}

Ausgabe

Hello, whirled!
Hello,
whirled!
+Hello,
+whirled!

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 25	C++98	n war das kleinere von os.width() und str.size()	n ist das größere von beiden
LWG 90	C++98	std::isspace(c, getloc()) wurde zur Prüfung verwendet für Leerzeichen, aber getloc ist nicht in <string> deklariert	ersetzt getloc() durch is.getloc()
LWG 91	C++98	operator>> verhielt sich nicht wie eine FormattedInputFunction	verhält sich wie eine FormattedInputFunction
LWG 211	C++98	operator>> setzte failbit nicht, wenn kein Zeichen extrahiert wurde	setzt failbit
LWG 435	C++98	Zeichen wurden mittels os.rdbuf()->sputn(str.data(), n) eingefügt, und die Auflösung von LWG-Problem 25 machte das Verhalten undefiniert, wenn os.width() größer als str.size() ist	bestimmt die Füllzeichen zuerst und fügt die aufgefüllte Zeichensequenz stattdessen ein
LWG 586	C++98	operator<< verhielt sich nicht wie eine FormattedOutputFunction	verhält sich wie eine FormattedOutputFunction

Siehe auch

operator<< (C++17)

führt die Stromausgabe auf Zeichenansichten durch (Funktionsschablone)