std::basic_stringbuf<CharT,Traits,Allocator>::view
| std::basic_string_view<CharT, Traits> view() const noexcept; |
(seit C++20) | |
Erstellt und gibt eine std::basic_string_view über die zugrunde liegende Zeichensequenz zurück.
- Für reine Eingabestreams repräsentiert die zurückgegebene Ansicht den Bereich [eback(), egptr()).
- Für Eingabe/Ausgabe- oder reine Ausgabestreams verweist auf die Zeichen von pbase() bis zum letzten Zeichen der Sequenz, unabhängig von egptr() und epptr().
- Wenn der Stream weder Eingabe noch Ausgabe ist, wird std::basic_string_view<CharT, Traits>{} zurückgegeben.
Die interne Zeichensequenz in einem für Schreibvorgänge geöffneten Puffer kann aus Effizienzgründen überdimensioniert sein. In diesem Fall werden nur die *initialisierten Zeichen* referenziert: diese Zeichen sind diejenigen, die aus dem String-Argument des Konstruktors, dem String-Argument, das bei der letzten Überladung von str() verwendet wurde, oder aus einer Schreiboperation stammen. Eine typische Implementierung, die Überdimensionierung verwendet, unterhält einen "High-Watermark"-Zeiger, um das Ende des initialisierten Teils des Puffers zu verfolgen, und die zurückgegebene Ansicht referenziert die Zeichen von pbase() bis zum "High-Watermark"-Zeiger.
Inhalt |
[bearbeiten] Parameter
(keine)
[bearbeiten] Rückgabewert
Eine Ansicht über die zugrunde liegende Zeichensequenz.
[bearbeiten] Hinweise
Die Verwendung des Rückgabewertes ist undefiniertes Verhalten, wenn die zugrunde liegende Zeichensequenz zerstört oder ungültig wird, es sei denn, der Rückgabewert ist leer.
Diese Funktion wird typischerweise über std::basic_istringstream::view(), std::basic_ostringstream::view() oder std::basic_stringstream::view() aufgerufen.
[bearbeiten] Siehe auch
| ersetzt oder ruft eine Kopie des zugeordneten Zeichenstrings ab (public member function) | |
| (C++17) |
gibt eine nicht modifizierbare basic_string_view in den gesamten String zurück(public member function of std::basic_string<CharT,Traits,Allocator>) |
