std::basic_stringbuf<CharT,Traits,Allocator>:: view
|
std::
basic_string_view
<
CharT, Traits
>
view
(
)
const
noexcept
;
|
(seit C++20) | |
Erstellt und gibt einen std::basic_string_view über die zugrunde liegende Zeichensequenz zurück.
- Für Nur-Eingabe-Streams repräsentiert die zurückgegebene Sicht den Bereich [ eback ( ) , egptr ( ) ) .
- Für Eingabe/Ausgabe- oder Nur-Ausgabe-Streams referenziert die Zeichen von pbase ( ) bis zum letzten Zeichen in 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 Zeichenfolge der Mitglieder in einem zum Schreiben geöffneten Puffer kann aus Effizienzgründen überallokiert werden. In diesem Fall werden nur die
initialisierten Zeichen
referenziert: dies sind die Zeichen, die aus dem String-Argument des Konstruktors, dem String-Argument des letzten Aufrufs einer Setter-Überladung von
str()
oder aus einem Schreibvorgang stammen. Eine typische Implementierung, die Over-Allocation verwendet, verwaltet einen High-Watermark-Zeiger, um das Ende des initialisierten Teils des Puffers zu verfolgen, und die zurückgegebene Sicht referenziert die Zeichen von
pbase
(
)
bis zum High-Watermark-Zeiger.
Inhaltsverzeichnis |
Parameter
(keine)
Rückgabewert
Ein Überblick über die zugrundeliegende Zeichensequenz.
Hinweise
Die Verwendung des Rückgabewerts ist undefiniertes Verhalten, wenn die zugrundeliegende 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.
Siehe auch
|
ersetzt oder erhält eine Kopie der assoziierten Zeichenkette
(öffentliche Elementfunktion) |
|
|
(C++17)
|
gibt eine nicht-modifizierbare
basic_string_view
der gesamten Zeichenkette zurück
(öffentliche Elementfunktion von
std::basic_string<CharT,Traits,Allocator>
)
|