Difference between revisions of "cpp/header/syncstream"
From cppreference.com
(from p0053r6) |
(move synopsis to template) |
||
(8 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
− | {{cpp/header/title|syncstream}} | + | {{cpp/header/title|syncstream|notes={{mark c++20}}}} |
{{cpp/header/navbar}} | {{cpp/header/navbar}} | ||
This header is part of the [[cpp/io|Input/Output]] library. | This header is part of the [[cpp/io|Input/Output]] library. | ||
{{dsc begin}} | {{dsc begin}} | ||
+ | {{dsc h1|Includes}} | ||
+ | {{dsc inc | cpp/header/dsc ostream}} | ||
+ | |||
{{dsc h1|Classes}} | {{dsc h1|Classes}} | ||
− | {{dsc | + | {{dsc inc | cpp/io/dsc basic_syncbuf}} |
− | {{dsc | + | {{dsc inc | cpp/io/dsc basic_osyncstream}} |
− | + | {{dsc | {{tt|syncbuf}} {{mark c++20}} | {{c|std::basic_syncbuf<char>}}<br>{{mark typedef}}}} | |
− | + | {{dsc | {{tt|wsyncbuf}} {{mark c++20}} | {{c|std::basic_syncbuf<wchar_t>}}<br>{{mark typedef}}}} | |
− | {{dsc | {{tt|syncbuf}} | {{c|basic_syncbuf<char>}}}} | + | {{dsc | {{tt|osyncstream}} {{mark c++20}} | {{c|std::basic_osyncstream<char>}}<br>{{mark typedef}}}} |
− | {{dsc | {{tt|wsyncbuf}} | {{c|basic_syncbuf<wchar_t>}}}} | + | {{dsc | {{tt|wosyncstream}} {{mark c++20}} | {{c|std::basic_osyncstream<wchar_t>}}<br>{{mark typedef}}}} |
− | {{dsc | {{tt|osyncstream}} | {{c|basic_osyncstream<char>}}}} | + | |
− | {{dsc | {{tt|wosyncstream}} | {{c|basic_osyncstream<wchar_t>}}}} | + | |
{{dsc h1|Functions}} | {{dsc h1|Functions}} | ||
Line 18: | Line 19: | ||
===Synopsis=== | ===Synopsis=== | ||
+ | {{cpp/synopsis/syncstream}} | ||
− | {{ | + | {{langlinks|es|ja|zh}} |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + |
Latest revision as of 06:49, 27 November 2023
This header is part of the Input/Output library.
Includes | ||
std::basic_ostream, std::basic_iostream class templates and typedefs | ||
Classes | ||
(C++20) |
synchronized output device wrapper (class template) | |
(C++20) |
synchronized output stream wrapper (class template) | |
syncbuf (C++20)
|
std::basic_syncbuf<char> (typedef) | |
wsyncbuf (C++20)
|
std::basic_syncbuf<wchar_t> (typedef) | |
osyncstream (C++20)
|
std::basic_osyncstream<char> (typedef) | |
wosyncstream (C++20)
|
std::basic_osyncstream<wchar_t> (typedef) | |
Functions | ||
specializes the std::swap algorithm (function template) |
[edit] Synopsis
#include <ostream> namespace std { template<class CharT, class Traits = char_traits<CharT>, class Allocator = allocator<CharT>> class basic_syncbuf; using syncbuf = basic_syncbuf<char>; using wsyncbuf = basic_syncbuf<wchar_t>; template<class CharT, class Traits = char_traits<CharT>, class Allocator = allocator<CharT>> class basic_osyncstream; using osyncstream = basic_osyncstream<char>; using wosyncstream = basic_osyncstream<wchar_t>; }
[edit] Class template std::basic_syncbuf
namespace std { template<class CharT, class Traits = char_traits<CharT>, class Allocator = allocator<CharT>> class basic_syncbuf : public basic_streambuf<CharT, Traits> { public: using char_type = CharT; using int_type = typename Traits::int_type; using pos_type = typename Traits::pos_type; using off_type = typename Traits::off_type; using traits_type = Traits; using allocator_type = Allocator; using streambuf_type = basic_streambuf<CharT, Traits>; // construction and destruction basic_syncbuf() : basic_syncbuf(nullptr) {} explicit basic_syncbuf(streambuf_type* obuf) : basic_syncbuf(obuf, Allocator()) {} basic_syncbuf(streambuf_type*, const Allocator&); basic_syncbuf(basic_syncbuf&&); ~basic_syncbuf(); // assignment and swap basic_syncbuf& operator=(basic_syncbuf&&); void swap(basic_syncbuf&); // member functions bool emit(); streambuf_type* get_wrapped() const noexcept; allocator_type get_allocator() const noexcept; void set_emit_on_sync(bool) noexcept; protected: // overridden virtual functions int sync() override; private: streambuf_type* wrapped; // exposition only bool emit_on_sync{}; // exposition only }; // specialized algorithms template<class CharT, class Traits, class Allocator> void swap(basic_syncbuf<CharT, Traits, Allocator>&, basic_syncbuf<CharT, Traits, Allocator>&); }
[edit] Class template std::basic_osyncstream
namespace std { template<class CharT, class Traits = char_traits<CharT>, class Allocator = allocator<CharT>> class basic_osyncstream : public basic_ostream<CharT, Traits> { public: using char_type = CharT; using int_type = typename Traits::int_type; using pos_type = typename Traits::pos_type; using off_type = typename Traits::off_type; using traits_type = Traits; using allocator_type = Allocator; using streambuf_type = basic_streambuf<CharT, Traits>; using syncbuf_type = basic_syncbuf<CharT, Traits, Allocator>; // construction and destruction basic_osyncstream(streambuf_type*, const Allocator&); explicit basic_osyncstream(streambuf_type* obuf) : basic_osyncstream(obuf, Allocator()) {} basic_osyncstream(basic_ostream<CharT, Traits>& os, const Allocator& allocator) : basic_osyncstream(os.rdbuf(), allocator) {} explicit basic_osyncstream(basic_ostream<CharT, Traits>& os) : basic_osyncstream(os, Allocator()) {} basic_osyncstream(basic_osyncstream&&) noexcept; ~basic_osyncstream(); // assignment basic_osyncstream& operator=(basic_osyncstream&&) noexcept; // member functions void emit(); streambuf_type* get_wrapped() const noexcept; syncbuf_type* rdbuf() const noexcept { return const_cast<syncbuf_type*>(addressof(sb)); } private: syncbuf_type sb; // exposition only }; }