std::basic_istringstream<CharT,Traits,Allocator>::str
Von cppreference.com
< cpp | io | basic istringstream
| (1) | ||
std::basic_string<CharT, Traits, Allocator> str() const; |
(bis C++20) | |
| std::basic_string<CharT, Traits, Allocator> str() const&; |
(seit C++20) | |
| template< class SAlloc > std::basic_string<CharT, Traits, SAlloc> str( const SAlloc& a ) const; |
(2) | (seit C++20) |
| std::basic_string<CharT, Traits, Allocator> str() &&; |
(3) | (seit C++20) |
| void str( const std::basic_string<CharT, Traits, Allocator>& s ); |
(4) | |
| template< class SAlloc > void str( const std::basic_string<CharT, Traits, SAlloc>& s ); |
(5) | (seit C++20) |
| void str( std::basic_string<CharT, Traits, Allocator>&& s ); |
(6) | (seit C++20) |
template< class StringViewLike > void str( const StringViewLike& t ); |
(7) | (seit C++26) |
Verwaltet den Inhalt des zugrundeliegenden String-Objekts.
1) Gibt eine Kopie des zugrundeliegenden Strings zurück. Äquivalent zu return rdbuf()->str();.
2) Gibt eine Kopie des zugrundeliegenden Strings zurück, wobei a als alloziator verwendet wird. Äquivalent zu return rdbuf()->str(a);.
3) Gibt einen String zurück, der aus dem zugrundeliegenden String per Move-Konstruktion erstellt wurde. Äquivalent zu return std::move(*rdbuf()).str();.
4,5) Ersetzt den Inhalt des zugrundeliegenden Strings. Äquivalent zu rdbuf()->str(s);.
6) Ersetzt den Inhalt des zugrundeliegenden Strings. Äquivalent zu rdbuf()->str(std::move(s));.
7) Ersetzt den Inhalt des zugrundeliegenden Strings. Äquivalent zu rdbuf()->str(t);.
Diese Überladung nimmt an der Overload Resolution teil, nur wenn is_convertible_v<const T&, basic_string_view<charT, traits>> true ist.
Inhalt |
[bearbeiten] Parameter
| s | - | neuer Inhalt des zugrundeliegenden Strings |
| t | - | ein Objekt (konvertierbar in std::basic_string_view), das als neuer Inhalt des zugrundeliegenden Strings verwendet werden soll |
| a | - | alloziator, der zum Konstruieren des zurückgegebenen Strings verwendet wird |
[bearbeiten] Rückgabewert
1,2) Eine Kopie des zugrundeliegenden String-Objekts.
3) Ein String, der aus dem zugrundeliegenden String-Objekt per Move-Konstruktion erstellt wurde.
4-7) (keine)
[bearbeiten] Hinweise
Die Kopie des zugrundeliegenden Strings, die von str zurückgegeben wird, ist ein temporäres Objekt, das am Ende des Ausdrucks zerstört wird. Daher führt das direkte Aufrufen von c_str() auf dem Ergebnis von str() (zum Beispiel in auto *ptr = out.str().c_str();) zu einem hängenden Zeiger.
| Feature-Test-Makro | Wert | Std | Feature |
|---|---|---|---|
__cpp_lib_sstream_from_string_view |
202306L |
(C++26) | Schnittstelle von std::stringstreams mit std::string_view, (7) |
[bearbeiten] Beispiel
Führen Sie diesen Code aus
#include <iostream> #include <sstream> int main() { int n; std::istringstream in; // could also use in("1 2") in.str("1 2"); in >> n; std::cout << "After reading the first int from \"1 2\", the int is " << n << ", str() = \"" << in.str() << "\"\n"; std::ostringstream out("1 2"); out << 3; std::cout << "After writing the int '3' to output stream \"1 2\"" << ", str() = \"" << out.str() << "\"\n"; std::ostringstream ate("1 2", std::ios_base::ate); ate << 3; std::cout << "After writing the int '3' to append stream \"1 2\"" << ", str() = \"" << ate.str() << "\"\n"; }
Ausgabe
After reading the first int from "1 2", the int is 1, str() = "1 2" After writing the int '3' to output stream "1 2", str() = "3 2" After writing the int '3' to append stream "1 2", str() = "1 23"
[bearbeiten] Siehe auch
| gibt das zugrunde liegende Rohstring-Geräteobjekt zurück (public member function) | |
| ersetzt oder ruft eine Kopie des zugeordneten Zeichenstrings ab (öffentliche Memberfunktion von std::basic_stringbuf<CharT,Traits,Allocator>) |
