std::ostrstream::freeze
Von cppreference.com
< cpp | io | ostrstream
| void freeze( bool flag = true ); |
(veraltet in C++98) (entfernt in C++26) |
|
Wenn der Stream ein dynamisch zugewiesenes Array für die Ausgabe verwendet, wird die automatische Zuweisung/Freigabe des Puffers deaktiviert (flag == true) oder aktiviert (flag == false). Ruft effektiv rdbuf()->freeze(flag) auf.
Inhalt |
[bearbeiten] Hinweise
Nach einem Aufruf von str() werden dynamische Streams automatisch "eingefroren". Ein Aufruf von freeze(false) ist erforderlich, bevor der Gültigkeitsbereich verlassen wird, in dem dieses ostrstream-Objekt erstellt wurde, da der Destruktor sonst Speicherlecks verursacht. Darüber hinaus kann die zusätzliche Ausgabe in einen eingefrorenen Stream abgeschnitten werden, sobald das Ende des zugewiesenen Puffers erreicht ist.
[bearbeiten] Parameter
| flag | - | gewünschter Status |
[bearbeiten] Rückgabewert
(keine)
[bearbeiten] Beispiel
Führen Sie diesen Code aus
#include <iostream> #include <strstream> int main() { std::ostrstream dyn; // dynamically-allocated output buffer dyn << "Test: " << 1.23; // note: no std::ends to demonstrate appending std::cout << "The output stream contains \""; std::cout.write(dyn.str(), dyn.pcount()) << "\"\n"; // the stream is now frozen due to str() dyn << " More text"; // output to a frozen stream may be truncated std::cout << "The output stream contains \""; std::cout.write(dyn.str(), dyn.pcount()) << "\"\n"; dyn.freeze(false); // freeze(false) must be called or the destructor will leak std::ostrstream dyn2; // dynamically-allocated output buffer dyn2 << "Test: " << 1.23; // note: no std::ends std::cout << "The output stream contains \""; std::cout.write(dyn2.str(), dyn2.pcount()) << "\"\n"; dyn2.freeze(false); // unfreeze the stream after str() dyn2 << " More text" << std::ends; // output will not be truncated (buffer grows) std::cout << "The output stream contains \"" << dyn2.str() << "\"\n"; dyn2.freeze(false); // freeze(false) must be called or the destructor will leak }
Mögliche Ausgabe
The output stream contains "Test: 1.23" The output stream contains "Test: 1.23 More " The output stream contains "Test: 1.23" The output stream contains "Test: 1.23 More text"
[bearbeiten] Siehe auch
| setzt/löscht den "frozen"-Zustand des Puffers (public member function of std::strstreambuf) |