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

Fügt Daten in den Stream ein.

Parameter

Rückgabewert

Hinweise

Es gibt keine Überladungen für Zeiger auf nicht-statische Member , Zeiger auf volatile-Objekte, (bis C++23) oder Funktionszeiger (außer denen mit Signaturen, die von den ( 18-20 ) Überladungen akzeptiert werden).

• Der Versuch, solche Objekte auszugeben, ruft eine implizite Konvertierung zu bool auf, und für jeden nicht-null Zeigerwert wird der Wert 1 ausgegeben (sofern nicht boolalpha gesetzt wurde, in welchem Fall true ausgegeben wird).

Zeichen- und Zeichenkettenargumente (z.B. vom Typ char oder const char * ) werden durch die Nicht-Member-Überladungen von operator << behandelt.

• Der Versuch, ein Zeichen mit der Memberfunktionsaufrufsyntax (z.B., std:: cout . operator << ( 'c' ) ; ) auszugeben, wird eine der Überladungen in ( 2-5 ) oder ( 11-14 ) aufrufen und den numerischen Wert ausgeben.
• Der Versuch, eine Zeichenkette mit der Memberfunktionsaufrufsyntax auszugeben, wird Überladung (8) aufrufen und stattdessen den Zeigerwert ausgeben.

Overload (10) wurde durch die Resolution von LWG-Issue 2221 hinzugefügt, wird jedoch in keiner Standardbibliothek-Implementierung unter C++11/14-Modi implementiert.

Beispiel

#include <iomanip>
#include <iostream>
#include <sstream>
int fun() { return 42; }
int main()
{
    std::istringstream input(" \"Some text.\" ");
    double f = 3.14;
    bool b = true;
    std::cout
        << fun()          // int Überladung (12)
        << ' '            // Nicht-Member-Überladung
        << std::boolalpha // Funktionsüberladung (18)
        << b              // bool Überladung (1)
        << " "            // Nicht-Member-Überladung
        << std::fixed     // Funktionsüberladung (18) erneut
        << f              // double Überladung (6)
        << input.rdbuf()  // streambuf Überladung
        << fun            // bool Überladung (1): Es gibt keine Überladung für int(*)()
        << std::endl;     // Funktionsüberladung (18) erneut
    int x = 0;
    int* p1 = &x;
    volatile int* p2 = &x;
    std::cout
        << "p1: " << p1 << '\n'  // `const void*` Überladung, gibt Adresse aus
        << "p2: " << p2 << '\n'; // Vor C++23 (P1147): bool Überladung :), weil
            // operator<<(const void*) keine Übereinstimmung ist, da es den `volatile`
            // Qualifizierer verwirft. Um dies zu beheben, fügt C++23 `const volatile void*` Überladung (9) hinzu,
            // die wie erwartet die Adresse ausgibt.
}

42 true 3.140000 "Some text." true
p1: 0x7ffcea766600
p2: 0x7ffcea766600

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

Siehe auch