| 1 | // Output streams -*- C++ -*- | 
 
 
 
 
 | 2 |  | 
 
 
 
 
 | 3 | // Copyright (C) 1997-2021 Free Software Foundation, Inc. | 
 
 
 
 
 | 4 | // | 
 
 
 
 
 | 5 | // This file is part of the GNU ISO C++ Library.  This library is free | 
 
 
 
 
 | 6 | // software; you can redistribute it and/or modify it under the | 
 
 
 
 
 | 7 | // terms of the GNU General Public License as published by the | 
 
 
 
 
 | 8 | // Free Software Foundation; either version 3, or (at your option) | 
 
 
 
 
 | 9 | // any later version. | 
 
 
 
 
 | 10 |  | 
 
 
 
 
 | 11 | // This library is distributed in the hope that it will be useful, | 
 
 
 
 
 | 12 | // but WITHOUT ANY WARRANTY; without even the implied warranty of | 
 
 
 
 
 | 13 | // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the | 
 
 
 
 
 | 14 | // GNU General Public License for more details. | 
 
 
 
 
 | 15 |  | 
 
 
 
 
 | 16 | // Under Section 7 of GPL version 3, you are granted additional | 
 
 
 
 
 | 17 | // permissions described in the GCC Runtime Library Exception, version | 
 
 
 
 
 | 18 | // 3.1, as published by the Free Software Foundation. | 
 
 
 
 
 | 19 |  | 
 
 
 
 
 | 20 | // You should have received a copy of the GNU General Public License and | 
 
 
 
 
 | 21 | // a copy of the GCC Runtime Library Exception along with this program; | 
 
 
 
 
 | 22 | // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see | 
 
 
 
 
 | 23 | // <http://www.gnu.org/licenses/>. | 
 
 
 
 
 | 24 |  | 
 
 
 
 
 | 25 | /** @file include/ostream | 
 
 
 
 
 | 26 | *  This is a Standard C++ Library header. | 
 
 
 
 
 | 27 | */ | 
 
 
 
 
 | 28 |  | 
 
 
 
 
 | 29 | // | 
 
 
 
 
 | 30 | // ISO C++ 14882: 27.6.2  Output streams | 
 
 
 
 
 | 31 | // | 
 
 
 
 
 | 32 |  | 
 
 
 
 
 | 33 | #ifndef _GLIBCXX_OSTREAM | 
 
 
 
 
 | 34 | #define _GLIBCXX_OSTREAM 1 | 
 
 
 
 
 | 35 |  | 
 
 
 
 
 | 36 | #pragma GCC system_header | 
 
 
 
 
 | 37 |  | 
 
 
 
 
 | 38 | #include <ios> | 
 
 
 
 
 | 39 | #include <bits/ostream_insert.h> | 
 
 
 
 
 | 40 |  | 
 
 
 
 
 | 41 | namespace std _GLIBCXX_VISIBILITY(default) | 
 
 
 
 
 | 42 | { | 
 
 
 
 
 | 43 | _GLIBCXX_BEGIN_NAMESPACE_VERSION | 
 
 
 
 
 | 44 |  | 
 
 
 
 
 | 45 | /** | 
 
 
 
 
 | 46 | *  @brief  Template class basic_ostream. | 
 
 
 
 
 | 47 | *  @ingroup io | 
 
 
 
 
 | 48 | * | 
 
 
 
 
 | 49 | *  @tparam _CharT  Type of character stream. | 
 
 
 
 
 | 50 | *  @tparam _Traits  Traits for character type, defaults to | 
 
 
 
 
 | 51 | *                   char_traits<_CharT>. | 
 
 
 
 
 | 52 | * | 
 
 
 
 
 | 53 | *  This is the base class for all output streams.  It provides text | 
 
 
 
 
 | 54 | *  formatting of all builtin types, and communicates with any class | 
 
 
 
 
 | 55 | *  derived from basic_streambuf to do the actual output. | 
 
 
 
 
 | 56 | */ | 
 
 
 
 
 | 57 | template<typename _CharT, typename _Traits> | 
 
 
 
 
 | 58 | class basic_ostream : virtual public basic_ios<_CharT, _Traits> | 
 
 
 
 
 | 59 | { | 
 
 
 
 
 | 60 | public: | 
 
 
 
 
 | 61 | // Types (inherited from basic_ios): | 
 
 
 
 
 | 62 | typedef _CharT                                    char_type; | 
 
 
 
 
 | 63 | typedef typename _Traits::int_type                int_type; | 
 
 
 
 
 | 64 | typedef typename _Traits::pos_type                pos_type; | 
 
 
 
 
 | 65 | typedef typename _Traits::off_type                off_type; | 
 
 
 
 
 | 66 | typedef _Traits                                   traits_type; | 
 
 
 
 
 | 67 |  | 
 
 
 
 
 | 68 | // Non-standard Types: | 
 
 
 
 
 | 69 | typedef basic_streambuf<_CharT, _Traits>          __streambuf_type; | 
 
 
 
 
 | 70 | typedef basic_ios<_CharT, _Traits>                __ios_type; | 
 
 
 
 
 | 71 | typedef basic_ostream<_CharT, _Traits>            __ostream_type; | 
 
 
 
 
 | 72 | typedef num_put<_CharT, ostreambuf_iterator<_CharT, _Traits> > | 
 
 
 
 
 | 73 | __num_put_type; | 
 
 
 
 
 | 74 | typedef ctype<_CharT>                             __ctype_type; | 
 
 
 
 
 | 75 |  | 
 
 
 
 
 | 76 | /** | 
 
 
 
 
 | 77 | *  @brief  Base constructor. | 
 
 
 
 
 | 78 | * | 
 
 
 
 
 | 79 | *  This ctor is almost never called by the user directly, rather from | 
 
 
 
 
 | 80 | *  derived classes' initialization lists, which pass a pointer to | 
 
 
 
 
 | 81 | *  their own stream buffer. | 
 
 
 
 
 | 82 | */ | 
 
 
 
 
 | 83 | explicit | 
 
 
 
 
 | 84 | basic_ostream(__streambuf_type* __sb) | 
 
 
 
 
 | 85 | { this->init(__sb); } | 
 
 
 
 
 | 86 |  | 
 
 
 
 
 | 87 | /** | 
 
 
 
 
 | 88 | *  @brief  Base destructor. | 
 
 
 
 
 | 89 | * | 
 
 
 
 
 | 90 | *  This does very little apart from providing a virtual base dtor. | 
 
 
 
 
 | 91 | */ | 
 
 
 
 
 | 92 | virtual | 
 
 
 
 
 | 93 | ~basic_ostream() { } | 
 
 
 
 
 | 94 |  | 
 
 
 
 
 | 95 | /// Safe prefix/suffix operations. | 
 
 
 
 
 | 96 | class sentry; | 
 
 
 
 
 | 97 | friend class sentry; | 
 
 
 
 
 | 98 |  | 
 
 
 
 
 | 99 | ///@{ | 
 
 
 
 
 | 100 | /** | 
 
 
 
 
 | 101 | *  @brief  Interface for manipulators. | 
 
 
 
 
 | 102 | * | 
 
 
 
 
 | 103 | *  Manipulators such as @c std::endl and @c std::hex use these | 
 
 
 
 
 | 104 | *  functions in constructs like "std::cout << std::endl".  For more | 
 
 
 
 
 | 105 | *  information, see the iomanip header. | 
 
 
 
 
 | 106 | */ | 
 
 
 
 
 | 107 | __ostream_type& | 
 
 
 
 
 | 108 | operator<<(__ostream_type& (*__pf)(__ostream_type&)) | 
 
 
 
 
 | 109 | { | 
 
 
 
 
 | 110 | // _GLIBCXX_RESOLVE_LIB_DEFECTS | 
 
 
 
 
 | 111 | // DR 60. What is a formatted input function? | 
 
 
 
 
 | 112 | // The inserters for manipulators are *not* formatted output functions. | 
 
 
 
 
 | 113 | return __pf(*this); | 
 
 
 
 
 | 114 | } | 
 
 
 
 
 | 115 |  | 
 
 
 
 
 | 116 | __ostream_type& | 
 
 
 
 
 | 117 | operator<<(__ios_type& (*__pf)(__ios_type&)) | 
 
 
 
 
 | 118 | { | 
 
 
 
 
 | 119 | // _GLIBCXX_RESOLVE_LIB_DEFECTS | 
 
 
 
 
 | 120 | // DR 60. What is a formatted input function? | 
 
 
 
 
 | 121 | // The inserters for manipulators are *not* formatted output functions. | 
 
 
 
 
 | 122 | __pf(*this); | 
 
 
 
 
 | 123 | return *this; | 
 
 
 
 
 | 124 | } | 
 
 
 
 
 | 125 |  | 
 
 
 
 
 | 126 | __ostream_type& | 
 
 
 
 
 | 127 | operator<<(ios_base& (*__pf) (ios_base&)) | 
 
 
 
 
 | 128 | { | 
 
 
 
 
 | 129 | // _GLIBCXX_RESOLVE_LIB_DEFECTS | 
 
 
 
 
 | 130 | // DR 60. What is a formatted input function? | 
 
 
 
 
 | 131 | // The inserters for manipulators are *not* formatted output functions. | 
 
 
 
 
 | 132 | __pf(*this); | 
 
 
 
 
 | 133 | return *this; | 
 
 
 
 
 | 134 | } | 
 
 
 
 
 | 135 | ///@} | 
 
 
 
 
 | 136 |  | 
 
 
 
 
 | 137 | ///@{ | 
 
 
 
 
 | 138 | /** | 
 
 
 
 
 | 139 | *  @name Inserters | 
 
 
 
 
 | 140 | * | 
 
 
 
 
 | 141 | *  All the @c operator<< functions (aka <em>formatted output | 
 
 
 
 
 | 142 | *  functions</em>) have some common behavior.  Each starts by | 
 
 
 
 
 | 143 | *  constructing a temporary object of type std::basic_ostream::sentry. | 
 
 
 
 
 | 144 | *  This can have several effects, concluding with the setting of a | 
 
 
 
 
 | 145 | *  status flag; see the sentry documentation for more. | 
 
 
 
 
 | 146 | * | 
 
 
 
 
 | 147 | *  If the sentry status is good, the function tries to generate | 
 
 
 
 
 | 148 | *  whatever data is appropriate for the type of the argument. | 
 
 
 
 
 | 149 | * | 
 
 
 
 
 | 150 | *  If an exception is thrown during insertion, ios_base::badbit | 
 
 
 
 
 | 151 | *  will be turned on in the stream's error state without causing an | 
 
 
 
 
 | 152 | *  ios_base::failure to be thrown.  The original exception will then | 
 
 
 
 
 | 153 | *  be rethrown. | 
 
 
 
 
 | 154 | */ | 
 
 
 
 
 | 155 |  | 
 
 
 
 
 | 156 | ///@{ | 
 
 
 
 
 | 157 | /** | 
 
 
 
 
 | 158 | *  @brief Integer arithmetic inserters | 
 
 
 
 
 | 159 | *  @param  __n A variable of builtin integral type. | 
 
 
 
 
 | 160 | *  @return  @c *this if successful | 
 
 
 
 
 | 161 | * | 
 
 
 
 
 | 162 | *  These functions use the stream's current locale (specifically, the | 
 
 
 
 
 | 163 | *  @c num_get facet) to perform numeric formatting. | 
 
 
 
 
 | 164 | */ | 
 
 
 
 
 | 165 | __ostream_type& | 
 
 
 
 
 | 166 | operator<<(long __n) | 
 
 
 
 
 | 167 | { return _M_insert(__n); } | 
 
 
 
 
 | 168 |  | 
 
 
 
 
 | 169 | __ostream_type& | 
 
 
 
 
 | 170 | operator<<(unsigned long __n) | 
 
 
 
 
 | 171 | { return _M_insert(__n); } | 
 
 
 
 
 | 172 |  | 
 
 
 
 
 | 173 | __ostream_type& | 
 
 
 
 
 | 174 | operator<<(bool __n) | 
 
 
 
 
 | 175 | { return _M_insert(__n); } | 
 
 
 
 
 | 176 |  | 
 
 
 
 
 | 177 | __ostream_type& | 
 
 
 
 
 | 178 | operator<<(short __n); | 
 
 
 
 
 | 179 |  | 
 
 
 
 
 | 180 | __ostream_type& | 
 
 
 
 
 | 181 | operator<<(unsigned short __n) | 
 
 
 
 
 | 182 | { | 
 
 
 
 
 | 183 | // _GLIBCXX_RESOLVE_LIB_DEFECTS | 
 
 
 
 
 | 184 | // 117. basic_ostream uses nonexistent num_put member functions. | 
 
 
 
 
 | 185 | return _M_insert(static_cast<unsigned long>(__n)); | 
 
 
 
 
 | 186 | } | 
 
 
 
 
 | 187 |  | 
 
 
 
 
 | 188 | __ostream_type& | 
 
 
 
 
 | 189 | operator<<(int __n); | 
 
 
 
 
 | 190 |  | 
 
 
 
 
 | 191 | __ostream_type& | 
 
 
 
 
 | 192 | operator<<(unsigned int __n) | 
 
 
 
 
 | 193 | { | 
 
 
 
 
 | 194 | // _GLIBCXX_RESOLVE_LIB_DEFECTS | 
 
 
 
 
 | 195 | // 117. basic_ostream uses nonexistent num_put member functions. | 
 
 
 
 
 | 196 | return _M_insert(static_cast<unsigned long>(__n)); | 
 
 
 
 
 | 197 | } | 
 
 
 
 
 | 198 |  | 
 
 
 
 
 | 199 | #ifdef _GLIBCXX_USE_LONG_LONG | 
 
 
 
 
 | 200 | __ostream_type& | 
 
 
 
 
 | 201 | operator<<(long long __n) | 
 
 
 
 
 | 202 | { return _M_insert(__n); } | 
 
 
 
 
 | 203 |  | 
 
 
 
 
 | 204 | __ostream_type& | 
 
 
 
 
 | 205 | operator<<(unsigned long long __n) | 
 
 
 
 
 | 206 | { return _M_insert(__n); } | 
 
 
 
 
 | 207 | #endif | 
 
 
 
 
 | 208 | ///@} | 
 
 
 
 
 | 209 |  | 
 
 
 
 
 | 210 | ///@{ | 
 
 
 
 
 | 211 | /** | 
 
 
 
 
 | 212 | *  @brief  Floating point arithmetic inserters | 
 
 
 
 
 | 213 | *  @param  __f A variable of builtin floating point type. | 
 
 
 
 
 | 214 | *  @return  @c *this if successful | 
 
 
 
 
 | 215 | * | 
 
 
 
 
 | 216 | *  These functions use the stream's current locale (specifically, the | 
 
 
 
 
 | 217 | *  @c num_get facet) to perform numeric formatting. | 
 
 
 
 
 | 218 | */ | 
 
 
 
 
 | 219 | __ostream_type& | 
 
 
 
 
 | 220 | operator<<(double __f) | 
 
 
 
 
 | 221 | { return _M_insert(__f); } | 
 
 
 
 
 | 222 |  | 
 
 
 
 
 | 223 | __ostream_type& | 
 
 
 
 
 | 224 | operator<<(float __f) | 
 
 
 
 
 | 225 | { | 
 
 
 
 
 | 226 | // _GLIBCXX_RESOLVE_LIB_DEFECTS | 
 
 
 
 
 | 227 | // 117. basic_ostream uses nonexistent num_put member functions. | 
 
 
 
 
 | 228 | return _M_insert(static_cast<double>(__f)); | 
 
 
 
 
 | 229 | } | 
 
 
 
 
 | 230 |  | 
 
 
 
 
 | 231 | __ostream_type& | 
 
 
 
 
 | 232 | operator<<(long double __f) | 
 
 
 
 
 | 233 | { return _M_insert(__f); } | 
 
 
 
 
 | 234 | ///@} | 
 
 
 
 
 | 235 |  | 
 
 
 
 
 | 236 | /** | 
 
 
 
 
 | 237 | *  @brief  Pointer arithmetic inserters | 
 
 
 
 
 | 238 | *  @param  __p A variable of pointer type. | 
 
 
 
 
 | 239 | *  @return  @c *this if successful | 
 
 
 
 
 | 240 | * | 
 
 
 
 
 | 241 | *  These functions use the stream's current locale (specifically, the | 
 
 
 
 
 | 242 | *  @c num_get facet) to perform numeric formatting. | 
 
 
 
 
 | 243 | */ | 
 
 
 
 
 | 244 | __ostream_type& | 
 
 
 
 
 | 245 | operator<<(const void* __p) | 
 
 
 
 
 | 246 | { return _M_insert(__p); } | 
 
 
 
 
 | 247 |  | 
 
 
 
 
 | 248 | #if __cplusplus >= 201703L | 
 
 
 
 
 | 249 | __ostream_type& | 
 
 
 
 
 | 250 | operator<<(nullptr_t) | 
 
 
 
 
 | 251 | { return *this << "nullptr"; } | 
 
 
 
 
 | 252 | #endif | 
 
 
 
 
 | 253 |  | 
 
 
 
 
 | 254 | /** | 
 
 
 
 
 | 255 | *  @brief  Extracting from another streambuf. | 
 
 
 
 
 | 256 | *  @param  __sb  A pointer to a streambuf | 
 
 
 
 
 | 257 | * | 
 
 
 
 
 | 258 | *  This function behaves like one of the basic arithmetic extractors, | 
 
 
 
 
 | 259 | *  in that it also constructs a sentry object and has the same error | 
 
 
 
 
 | 260 | *  handling behavior. | 
 
 
 
 
 | 261 | * | 
 
 
 
 
 | 262 | *  If @p __sb is NULL, the stream will set failbit in its error state. | 
 
 
 
 
 | 263 | * | 
 
 
 
 
 | 264 | *  Characters are extracted from @p __sb and inserted into @c *this | 
 
 
 
 
 | 265 | *  until one of the following occurs: | 
 
 
 
 
 | 266 | * | 
 
 
 
 
 | 267 | *  - the input stream reaches end-of-file, | 
 
 
 
 
 | 268 | *  - insertion into the output sequence fails (in this case, the | 
 
 
 
 
 | 269 | *    character that would have been inserted is not extracted), or | 
 
 
 
 
 | 270 | *  - an exception occurs while getting a character from @p __sb, which | 
 
 
 
 
 | 271 | *    sets failbit in the error state | 
 
 
 
 
 | 272 | * | 
 
 
 
 
 | 273 | *  If the function inserts no characters, failbit is set. | 
 
 
 
 
 | 274 | */ | 
 
 
 
 
 | 275 | __ostream_type& | 
 
 
 
 
 | 276 | operator<<(__streambuf_type* __sb); | 
 
 
 
 
 | 277 | ///@} | 
 
 
 
 
 | 278 |  | 
 
 
 
 
 | 279 | ///@{ | 
 
 
 
 
 | 280 | /** | 
 
 
 
 
 | 281 | *  @name Unformatted Output Functions | 
 
 
 
 
 | 282 | * | 
 
 
 
 
 | 283 | *  All the unformatted output functions have some common behavior. | 
 
 
 
 
 | 284 | *  Each starts by constructing a temporary object of type | 
 
 
 
 
 | 285 | *  std::basic_ostream::sentry.  This has several effects, concluding | 
 
 
 
 
 | 286 | *  with the setting of a status flag; see the sentry documentation | 
 
 
 
 
 | 287 | *  for more. | 
 
 
 
 
 | 288 | * | 
 
 
 
 
 | 289 | *  If the sentry status is good, the function tries to generate | 
 
 
 
 
 | 290 | *  whatever data is appropriate for the type of the argument. | 
 
 
 
 
 | 291 | * | 
 
 
 
 
 | 292 | *  If an exception is thrown during insertion, ios_base::badbit | 
 
 
 
 
 | 293 | *  will be turned on in the stream's error state.  If badbit is on in | 
 
 
 
 
 | 294 | *  the stream's exceptions mask, the exception will be rethrown | 
 
 
 
 
 | 295 | *  without completing its actions. | 
 
 
 
 
 | 296 | */ | 
 
 
 
 
 | 297 |  | 
 
 
 
 
 | 298 | /** | 
 
 
 
 
 | 299 | *  @brief  Simple insertion. | 
 
 
 
 
 | 300 | *  @param  __c  The character to insert. | 
 
 
 
 
 | 301 | *  @return  *this | 
 
 
 
 
 | 302 | * | 
 
 
 
 
 | 303 | *  Tries to insert @p __c. | 
 
 
 
 
 | 304 | * | 
 
 
 
 
 | 305 | *  @note  This function is not overloaded on signed char and | 
 
 
 
 
 | 306 | *         unsigned char. | 
 
 
 
 
 | 307 | */ | 
 
 
 
 
 | 308 | __ostream_type& | 
 
 
 
 
 | 309 | put(char_type __c); | 
 
 
 
 
 | 310 |  | 
 
 
 
 
 | 311 | /** | 
 
 
 
 
 | 312 | *  @brief  Core write functionality, without sentry. | 
 
 
 
 
 | 313 | *  @param  __s  The array to insert. | 
 
 
 
 
 | 314 | *  @param  __n  Maximum number of characters to insert. | 
 
 
 
 
 | 315 | */ | 
 
 
 
 
 | 316 | void | 
 
 
 
 
 | 317 | _M_write(const char_type* __s, streamsize __n) | 
 
 
 
 
 | 318 | { | 
 
 
 
 
 | 319 | const streamsize __put = this->rdbuf()->sputn(__s, __n); | 
 
 
 
 
 | 320 | if (__put != __n) | 
 
 
 
 
 | 321 | this->setstate(ios_base::badbit); | 
 
 
 
 
 | 322 | } | 
 
 
 
 
 | 323 |  | 
 
 
 
 
 | 324 | /** | 
 
 
 
 
 | 325 | *  @brief  Character string insertion. | 
 
 
 
 
 | 326 | *  @param  __s  The array to insert. | 
 
 
 
 
 | 327 | *  @param  __n  Maximum number of characters to insert. | 
 
 
 
 
 | 328 | *  @return  *this | 
 
 
 
 
 | 329 | * | 
 
 
 
 
 | 330 | *  Characters are copied from @p __s and inserted into the stream until | 
 
 
 
 
 | 331 | *  one of the following happens: | 
 
 
 
 
 | 332 | * | 
 
 
 
 
 | 333 | *  - @p __n characters are inserted | 
 
 
 
 
 | 334 | *  - inserting into the output sequence fails (in this case, badbit | 
 
 
 
 
 | 335 | *    will be set in the stream's error state) | 
 
 
 
 
 | 336 | * | 
 
 
 
 
 | 337 | *  @note  This function is not overloaded on signed char and | 
 
 
 
 
 | 338 | *         unsigned char. | 
 
 
 
 
 | 339 | */ | 
 
 
 
 
 | 340 | __ostream_type& | 
 
 
 
 
 | 341 | write(const char_type* __s, streamsize __n); | 
 
 
 
 
 | 342 | ///@} | 
 
 
 
 
 | 343 |  | 
 
 
 
 
 | 344 | /** | 
 
 
 
 
 | 345 | *  @brief  Synchronizing the stream buffer. | 
 
 
 
 
 | 346 | *  @return  *this | 
 
 
 
 
 | 347 | * | 
 
 
 
 
 | 348 | *  If @c rdbuf() is a null pointer, changes nothing. | 
 
 
 
 
 | 349 | * | 
 
 
 
 
 | 350 | *  Otherwise, calls @c rdbuf()->pubsync(), and if that returns -1, | 
 
 
 
 
 | 351 | *  sets badbit. | 
 
 
 
 
 | 352 | */ | 
 
 
 
 
 | 353 | __ostream_type& | 
 
 
 
 
 | 354 | flush(); | 
 
 
 
 
 | 355 |  | 
 
 
 
 
 | 356 | /** | 
 
 
 
 
 | 357 | *  @brief  Getting the current write position. | 
 
 
 
 
 | 358 | *  @return  A file position object. | 
 
 
 
 
 | 359 | * | 
 
 
 
 
 | 360 | *  If @c fail() is not false, returns @c pos_type(-1) to indicate | 
 
 
 
 
 | 361 | *  failure.  Otherwise returns @c rdbuf()->pubseekoff(0,cur,out). | 
 
 
 
 
 | 362 | */ | 
 
 
 
 
 | 363 | pos_type | 
 
 
 
 
 | 364 | tellp(); | 
 
 
 
 
 | 365 |  | 
 
 
 
 
 | 366 | /** | 
 
 
 
 
 | 367 | *  @brief  Changing the current write position. | 
 
 
 
 
 | 368 | *  @param  __pos  A file position object. | 
 
 
 
 
 | 369 | *  @return  *this | 
 
 
 
 
 | 370 | * | 
 
 
 
 
 | 371 | *  If @c fail() is not true, calls @c rdbuf()->pubseekpos(pos).  If | 
 
 
 
 
 | 372 | *  that function fails, sets failbit. | 
 
 
 
 
 | 373 | */ | 
 
 
 
 
 | 374 | __ostream_type& | 
 
 
 
 
 | 375 | seekp(pos_type); | 
 
 
 
 
 | 376 |  | 
 
 
 
 
 | 377 | /** | 
 
 
 
 
 | 378 | *  @brief  Changing the current write position. | 
 
 
 
 
 | 379 | *  @param  __off  A file offset object. | 
 
 
 
 
 | 380 | *  @param  __dir  The direction in which to seek. | 
 
 
 
 
 | 381 | *  @return  *this | 
 
 
 
 
 | 382 | * | 
 
 
 
 
 | 383 | *  If @c fail() is not true, calls @c rdbuf()->pubseekoff(off,dir). | 
 
 
 
 
 | 384 | *  If that function fails, sets failbit. | 
 
 
 
 
 | 385 | */ | 
 
 
 
 
 | 386 | __ostream_type& | 
 
 
 
 
 | 387 | seekp(off_type, ios_base::seekdir); | 
 
 
 
 
 | 388 |  | 
 
 
 
 
 | 389 | protected: | 
 
 
 
 
 | 390 | basic_ostream() | 
 
 
 
 
 | 391 | { this->init(0); } | 
 
 
 
 
 | 392 |  | 
 
 
 
 
 | 393 | #if __cplusplus >= 201103L | 
 
 
 
 
 | 394 | // Non-standard constructor that does not call init() | 
 
 
 
 
 | 395 | basic_ostream(basic_iostream<_CharT, _Traits>&) { } | 
 
 
 
 
 | 396 |  | 
 
 
 
 
 | 397 | basic_ostream(const basic_ostream&) = delete; | 
 
 
 
 
 | 398 |  | 
 
 
 
 
 | 399 | basic_ostream(basic_ostream&& __rhs) | 
 
 
 
 
 | 400 | : __ios_type() | 
 
 
 
 
 | 401 | { __ios_type::move(__rhs); } | 
 
 
 
 
 | 402 |  | 
 
 
 
 
 | 403 | // 27.7.3.3 Assign/swap | 
 
 
 
 
 | 404 |  | 
 
 
 
 
 | 405 | basic_ostream& operator=(const basic_ostream&) = delete; | 
 
 
 
 
 | 406 |  | 
 
 
 
 
 | 407 | basic_ostream& | 
 
 
 
 
 | 408 | operator=(basic_ostream&& __rhs) | 
 
 
 
 
 | 409 | { | 
 
 
 
 
 | 410 | swap(__rhs); | 
 
 
 
 
 | 411 | return *this; | 
 
 
 
 
 | 412 | } | 
 
 
 
 
 | 413 |  | 
 
 
 
 
 | 414 | void | 
 
 
 
 
 | 415 | swap(basic_ostream& __rhs) | 
 
 
 
 
 | 416 | { __ios_type::swap(__rhs); } | 
 
 
 
 
 | 417 | #endif | 
 
 
 
 
 | 418 |  | 
 
 
 
 
 | 419 | template<typename _ValueT> | 
 
 
 
 
 | 420 | __ostream_type& | 
 
 
 
 
 | 421 | _M_insert(_ValueT __v); | 
 
 
 
 
 | 422 | }; | 
 
 
 
 
 | 423 |  | 
 
 
 
 
 | 424 | /** | 
 
 
 
 
 | 425 | *  @brief  Performs setup work for output streams. | 
 
 
 
 
 | 426 | * | 
 
 
 
 
 | 427 | *  Objects of this class are created before all of the standard | 
 
 
 
 
 | 428 | *  inserters are run.  It is responsible for <em>exception-safe prefix and | 
 
 
 
 
 | 429 | *  suffix operations</em>. | 
 
 
 
 
 | 430 | */ | 
 
 
 
 
 | 431 | template <typename _CharT, typename _Traits> | 
 
 
 
 
 | 432 | class basic_ostream<_CharT, _Traits>::sentry | 
 
 
 
 
 | 433 | { | 
 
 
 
 
 | 434 | // Data Members. | 
 
 
 
 
 | 435 | bool                              _M_ok; | 
 
 
 
 
 | 436 | basic_ostream<_CharT, _Traits>&   _M_os; | 
 
 
 
 
 | 437 |  | 
 
 
 
 
 | 438 | public: | 
 
 
 
 
 | 439 | /** | 
 
 
 
 
 | 440 | *  @brief  The constructor performs preparatory work. | 
 
 
 
 
 | 441 | *  @param  __os  The output stream to guard. | 
 
 
 
 
 | 442 | * | 
 
 
 
 
 | 443 | *  If the stream state is good (@a __os.good() is true), then if the | 
 
 
 
 
 | 444 | *  stream is tied to another output stream, @c is.tie()->flush() | 
 
 
 
 
 | 445 | *  is called to synchronize the output sequences. | 
 
 
 
 
 | 446 | * | 
 
 
 
 
 | 447 | *  If the stream state is still good, then the sentry state becomes | 
 
 
 
 
 | 448 | *  true (@a okay). | 
 
 
 
 
 | 449 | */ | 
 
 
 
 
 | 450 | explicit | 
 
 
 
 
 | 451 | sentry(basic_ostream<_CharT, _Traits>& __os); | 
 
 
 
 
 | 452 |  | 
 
 
 
 
 | 453 | #pragma GCC diagnostic push | 
 
 
 
 
 | 454 | #pragma GCC diagnostic ignored "-Wdeprecated-declarations" | 
 
 
 
 
 | 455 | /** | 
 
 
 
 
 | 456 | *  @brief  Possibly flushes the stream. | 
 
 
 
 
 | 457 | * | 
 
 
 
 
 | 458 | *  If @c ios_base::unitbuf is set in @c os.flags(), and | 
 
 
 
 
 | 459 | *  @c std::uncaught_exception() is true, the sentry destructor calls | 
 
 
 
 
 | 460 | *  @c flush() on the output stream. | 
 
 
 
 
 | 461 | */ | 
 
 
 
 
 | 462 | ~sentry() | 
 
 
 
 
 | 463 | { | 
 
 
 
 
 | 464 | // XXX MT | 
 
 
 
 
 | 465 | if (bool(_M_os.flags() & ios_base::unitbuf) && !uncaught_exception()) | 
 
 
 
 
 | 466 | { | 
 
 
 
 
 | 467 | // Can't call flush directly or else will get into recursive lock. | 
 
 
 
 
 | 468 | if (_M_os.rdbuf() && _M_os.rdbuf()->pubsync() == -1) | 
 
 
 
 
 | 469 | _M_os.setstate(ios_base::badbit); | 
 
 
 
 
 | 470 | } | 
 
 
 
 
 | 471 | } | 
 
 
 
 
 | 472 | #pragma GCC diagnostic pop | 
 
 
 
 
 | 473 |  | 
 
 
 
 
 | 474 | /** | 
 
 
 
 
 | 475 | *  @brief  Quick status checking. | 
 
 
 
 
 | 476 | *  @return  The sentry state. | 
 
 
 
 
 | 477 | * | 
 
 
 
 
 | 478 | *  For ease of use, sentries may be converted to booleans.  The | 
 
 
 
 
 | 479 | *  return value is that of the sentry state (true == okay). | 
 
 
 
 
 | 480 | */ | 
 
 
 
 
 | 481 | #if __cplusplus >= 201103L | 
 
 
 
 
 | 482 | explicit | 
 
 
 
 
 | 483 | #endif | 
 
 
 
 
 | 484 | operator bool() const | 
 
 
 
 
 | 485 | { return _M_ok; } | 
 
 
 
 
 | 486 | }; | 
 
 
 
 
 | 487 |  | 
 
 
 
 
 | 488 | ///@{ | 
 
 
 
 
 | 489 | /** | 
 
 
 
 
 | 490 | *  @brief  Character inserters | 
 
 
 
 
 | 491 | *  @param  __out  An output stream. | 
 
 
 
 
 | 492 | *  @param  __c  A character. | 
 
 
 
 
 | 493 | *  @return  out | 
 
 
 
 
 | 494 | * | 
 
 
 
 
 | 495 | *  Behaves like one of the formatted arithmetic inserters described in | 
 
 
 
 
 | 496 | *  std::basic_ostream.  After constructing a sentry object with good | 
 
 
 
 
 | 497 | *  status, this function inserts a single character and any required | 
 
 
 
 
 | 498 | *  padding (as determined by [22.2.2.2.2]).  @c __out.width(0) is then | 
 
 
 
 
 | 499 | *  called. | 
 
 
 
 
 | 500 | * | 
 
 
 
 
 | 501 | *  If @p __c is of type @c char and the character type of the stream is not | 
 
 
 
 
 | 502 | *  @c char, the character is widened before insertion. | 
 
 
 
 
 | 503 | */ | 
 
 
 
 
 | 504 | template<typename _CharT, typename _Traits> | 
 
 
 
 
 | 505 | inline basic_ostream<_CharT, _Traits>& | 
 
 
 
 
 | 506 | operator<<(basic_ostream<_CharT, _Traits>& __out, _CharT __c) | 
 
 
 
 
 | 507 | { return __ostream_insert(__out, &__c, 1); } | 
 
 
 
 
 | 508 |  | 
 
 
 
 
 | 509 | template<typename _CharT, typename _Traits> | 
 
 
 
 
 | 510 | inline basic_ostream<_CharT, _Traits>& | 
 
 
 
 
 | 511 | operator<<(basic_ostream<_CharT, _Traits>& __out, char __c) | 
 
 
 
 
 | 512 | { return (__out << __out.widen(__c)); } | 
 
 
 
 
 | 513 |  | 
 
 
 
 
 | 514 | // Specialization | 
 
 
 
 
 | 515 | template<typename _Traits> | 
 
 
 
 
 | 516 | inline basic_ostream<char, _Traits>& | 
 
 
 
 
 | 517 | operator<<(basic_ostream<char, _Traits>& __out, char __c) | 
 
 
 
 
 | 518 | { return __ostream_insert(__out, &__c, 1); } | 
 
 
 
 
 | 519 |  | 
 
 
 
 
 | 520 | // Signed and unsigned | 
 
 
 
 
 | 521 | template<typename _Traits> | 
 
 
 
 
 | 522 | inline basic_ostream<char, _Traits>& | 
 
 
 
 
 | 523 | operator<<(basic_ostream<char, _Traits>& __out, signed char __c) | 
 
 
 
 
 | 524 | { return (__out << static_cast<char>(__c)); } | 
 
 
 
 
 | 525 |  | 
 
 
 
 
 | 526 | template<typename _Traits> | 
 
 
 
 
 | 527 | inline basic_ostream<char, _Traits>& | 
 
 
 
 
 | 528 | operator<<(basic_ostream<char, _Traits>& __out, unsigned char __c) | 
 
 
 
 
 | 529 | { return (__out << static_cast<char>(__c)); } | 
 
 
 
 
 | 530 |  | 
 
 
 
 
 | 531 | #if __cplusplus > 201703L | 
 
 
 
 
 | 532 | // The following deleted overloads prevent formatting character values as | 
 
 
 
 
 | 533 | // numeric values. | 
 
 
 
 
 | 534 |  | 
 
 
 
 
 | 535 | #ifdef _GLIBCXX_USE_WCHAR_T | 
 
 
 
 
 | 536 | template<typename _Traits> | 
 
 
 
 
 | 537 | basic_ostream<char, _Traits>& | 
 
 
 
 
 | 538 | operator<<(basic_ostream<char, _Traits>&, wchar_t) = delete; | 
 
 
 
 
 | 539 | #endif // _GLIBCXX_USE_WCHAR_T | 
 
 
 
 
 | 540 |  | 
 
 
 
 
 | 541 | #ifdef _GLIBCXX_USE_CHAR8_T | 
 
 
 
 
 | 542 | template<typename _Traits> | 
 
 
 
 
 | 543 | basic_ostream<char, _Traits>& | 
 
 
 
 
 | 544 | operator<<(basic_ostream<char, _Traits>&, char8_t) = delete; | 
 
 
 
 
 | 545 | #endif | 
 
 
 
 
 | 546 |  | 
 
 
 
 
 | 547 | template<typename _Traits> | 
 
 
 
 
 | 548 | basic_ostream<char, _Traits>& | 
 
 
 
 
 | 549 | operator<<(basic_ostream<char, _Traits>&, char16_t) = delete; | 
 
 
 
 
 | 550 |  | 
 
 
 
 
 | 551 | template<typename _Traits> | 
 
 
 
 
 | 552 | basic_ostream<char, _Traits>& | 
 
 
 
 
 | 553 | operator<<(basic_ostream<char, _Traits>&, char32_t) = delete; | 
 
 
 
 
 | 554 |  | 
 
 
 
 
 | 555 | #ifdef _GLIBCXX_USE_WCHAR_T | 
 
 
 
 
 | 556 | #ifdef _GLIBCXX_USE_CHAR8_T | 
 
 
 
 
 | 557 | template<typename _Traits> | 
 
 
 
 
 | 558 | basic_ostream<wchar_t, _Traits>& | 
 
 
 
 
 | 559 | operator<<(basic_ostream<wchar_t, _Traits>&, char8_t) = delete; | 
 
 
 
 
 | 560 | #endif // _GLIBCXX_USE_CHAR8_T | 
 
 
 
 
 | 561 |  | 
 
 
 
 
 | 562 | template<typename _Traits> | 
 
 
 
 
 | 563 | basic_ostream<wchar_t, _Traits>& | 
 
 
 
 
 | 564 | operator<<(basic_ostream<wchar_t, _Traits>&, char16_t) = delete; | 
 
 
 
 
 | 565 |  | 
 
 
 
 
 | 566 | template<typename _Traits> | 
 
 
 
 
 | 567 | basic_ostream<wchar_t, _Traits>& | 
 
 
 
 
 | 568 | operator<<(basic_ostream<wchar_t, _Traits>&, char32_t) = delete; | 
 
 
 
 
 | 569 | #endif // _GLIBCXX_USE_WCHAR_T | 
 
 
 
 
 | 570 | #endif // C++20 | 
 
 
 
 
 | 571 | ///@} | 
 
 
 
 
 | 572 |  | 
 
 
 
 
 | 573 | ///@{ | 
 
 
 
 
 | 574 | /** | 
 
 
 
 
 | 575 | *  @brief  String inserters | 
 
 
 
 
 | 576 | *  @param  __out  An output stream. | 
 
 
 
 
 | 577 | *  @param  __s  A character string. | 
 
 
 
 
 | 578 | *  @return  out | 
 
 
 
 
 | 579 | *  @pre  @p __s must be a non-NULL pointer | 
 
 
 
 
 | 580 | * | 
 
 
 
 
 | 581 | *  Behaves like one of the formatted arithmetic inserters described in | 
 
 
 
 
 | 582 | *  std::basic_ostream.  After constructing a sentry object with good | 
 
 
 
 
 | 583 | *  status, this function inserts @c traits::length(__s) characters starting | 
 
 
 
 
 | 584 | *  at @p __s, widened if necessary, followed by any required padding (as | 
 
 
 
 
 | 585 | *  determined by [22.2.2.2.2]).  @c __out.width(0) is then called. | 
 
 
 
 
 | 586 | */ | 
 
 
 
 
 | 587 | template<typename _CharT, typename _Traits> | 
 
 
 
 
 | 588 | inline basic_ostream<_CharT, _Traits>& | 
 
 
 
 
 | 589 | operator<<(basic_ostream<_CharT, _Traits>& __out, const _CharT* __s) | 
 
 
 
 
 | 590 | { | 
 
 
 
 
 | 591 | if (!__s) | 
 
 
 
 
 | 592 | __out.setstate(ios_base::badbit); | 
 
 
 
 
 | 593 | else | 
 
 
 
 
 | 594 | __ostream_insert(__out, __s, | 
 
 
 
 
 | 595 | static_cast<streamsize>(_Traits::length(__s))); | 
 
 
 
 
 | 596 | return __out; | 
 
 
 
 
 | 597 | } | 
 
 
 
 
 | 598 |  | 
 
 
 
 
 | 599 | template<typename _CharT, typename _Traits> | 
 
 
 
 
 | 600 | basic_ostream<_CharT, _Traits> & | 
 
 
 
 
 | 601 | operator<<(basic_ostream<_CharT, _Traits>& __out, const char* __s); | 
 
 
 
 
 | 602 |  | 
 
 
 
 
 | 603 | // Partial specializations | 
 
 
 
 
 | 604 | template<typename _Traits> | 
 
 
 
 
 | 605 | inline basic_ostream<char, _Traits>& | 
 
 
 
 
 | 606 | operator<<(basic_ostream<char, _Traits>& __out, const char* __s) | 
 
 
 
 
 | 607 | { | 
 
 
 
 
 | 608 | if (!__s) | 
 
 
 
 
 | 609 | __out.setstate(ios_base::badbit); | 
 
 
 
 
 | 610 | else | 
 
 
 
 
 | 611 | __ostream_insert(__out, __s, | 
 
 
 
 
 | 612 | static_cast<streamsize>(_Traits::length(__s))); | 
 
 
 
 
 | 613 | return __out; | 
 
 
 
 
 | 614 | } | 
 
 
 
 
 | 615 |  | 
 
 
 
 
 | 616 | // Signed and unsigned | 
 
 
 
 
 | 617 | template<typename _Traits> | 
 
 
 
 
 | 618 | inline basic_ostream<char, _Traits>& | 
 
 
 
 
 | 619 | operator<<(basic_ostream<char, _Traits>& __out, const signed char* __s) | 
 
 
 
 
 | 620 | { return (__out << reinterpret_cast<const char*>(__s)); } | 
 
 
 
 
 | 621 |  | 
 
 
 
 
 | 622 | template<typename _Traits> | 
 
 
 
 
 | 623 | inline basic_ostream<char, _Traits> & | 
 
 
 
 
 | 624 | operator<<(basic_ostream<char, _Traits>& __out, const unsigned char* __s) | 
 
 
 
 
 | 625 | { return (__out << reinterpret_cast<const char*>(__s)); } | 
 
 
 
 
 | 626 |  | 
 
 
 
 
 | 627 | #if __cplusplus > 201703L | 
 
 
 
 
 | 628 | // The following deleted overloads prevent formatting strings as | 
 
 
 
 
 | 629 | // pointer values. | 
 
 
 
 
 | 630 |  | 
 
 
 
 
 | 631 | #ifdef _GLIBCXX_USE_WCHAR_T | 
 
 
 
 
 | 632 | template<typename _Traits> | 
 
 
 
 
 | 633 | basic_ostream<char, _Traits>& | 
 
 
 
 
 | 634 | operator<<(basic_ostream<char, _Traits>&, const wchar_t*) = delete; | 
 
 
 
 
 | 635 | #endif // _GLIBCXX_USE_WCHAR_T | 
 
 
 
 
 | 636 |  | 
 
 
 
 
 | 637 | #ifdef _GLIBCXX_USE_CHAR8_T | 
 
 
 
 
 | 638 | template<typename _Traits> | 
 
 
 
 
 | 639 | basic_ostream<char, _Traits>& | 
 
 
 
 
 | 640 | operator<<(basic_ostream<char, _Traits>&, const char8_t*) = delete; | 
 
 
 
 
 | 641 | #endif // _GLIBCXX_USE_CHAR8_T | 
 
 
 
 
 | 642 |  | 
 
 
 
 
 | 643 | template<typename _Traits> | 
 
 
 
 
 | 644 | basic_ostream<char, _Traits>& | 
 
 
 
 
 | 645 | operator<<(basic_ostream<char, _Traits>&, const char16_t*) = delete; | 
 
 
 
 
 | 646 |  | 
 
 
 
 
 | 647 | template<typename _Traits> | 
 
 
 
 
 | 648 | basic_ostream<char, _Traits>& | 
 
 
 
 
 | 649 | operator<<(basic_ostream<char, _Traits>&, const char32_t*) = delete; | 
 
 
 
 
 | 650 |  | 
 
 
 
 
 | 651 | #ifdef _GLIBCXX_USE_WCHAR_T | 
 
 
 
 
 | 652 | #ifdef _GLIBCXX_USE_CHAR8_T | 
 
 
 
 
 | 653 | template<typename _Traits> | 
 
 
 
 
 | 654 | basic_ostream<wchar_t, _Traits>& | 
 
 
 
 
 | 655 | operator<<(basic_ostream<wchar_t, _Traits>&, const char8_t*) = delete; | 
 
 
 
 
 | 656 | #endif | 
 
 
 
 
 | 657 |  | 
 
 
 
 
 | 658 | template<typename _Traits> | 
 
 
 
 
 | 659 | basic_ostream<wchar_t, _Traits>& | 
 
 
 
 
 | 660 | operator<<(basic_ostream<wchar_t, _Traits>&, const char16_t*) = delete; | 
 
 
 
 
 | 661 |  | 
 
 
 
 
 | 662 | template<typename _Traits> | 
 
 
 
 
 | 663 | basic_ostream<wchar_t, _Traits>& | 
 
 
 
 
 | 664 | operator<<(basic_ostream<wchar_t, _Traits>&, const char32_t*) = delete; | 
 
 
 
 
 | 665 | #endif // _GLIBCXX_USE_WCHAR_T | 
 
 
 
 
 | 666 | #endif // C++20 | 
 
 
 
 
 | 667 | ///@} | 
 
 
 
 
 | 668 |  | 
 
 
 
 
 | 669 | // Standard basic_ostream manipulators | 
 
 
 
 
 | 670 |  | 
 
 
 
 
 | 671 | /** | 
 
 
 
 
 | 672 | *  @brief  Write a newline and flush the stream. | 
 
 
 
 
 | 673 | * | 
 
 
 
 
 | 674 | *  This manipulator is often mistakenly used when a simple newline is | 
 
 
 
 
 | 675 | *  desired, leading to poor buffering performance.  See | 
 
 
 
 
 | 676 | *  https://gcc.gnu.org/onlinedocs/libstdc++/manual/streambufs.html#io.streambuf.buffering | 
 
 
 
 
 | 677 | *  for more on this subject. | 
 
 
 
 
 | 678 | */ | 
 
 
 
 
 | 679 | template<typename _CharT, typename _Traits> | 
 
 
 
 
 | 680 | inline basic_ostream<_CharT, _Traits>& | 
 
 
 
 
 | 681 | endl(basic_ostream<_CharT, _Traits>& __os) | 
 
 
 
 
 | 682 | { return flush(__os.put(__os.widen('\n'))); } | 
 
 
 
 
 | 683 |  | 
 
 
 
 
 | 684 | /** | 
 
 
 
 
 | 685 | *  @brief  Write a null character into the output sequence. | 
 
 
 
 
 | 686 | * | 
 
 
 
 
 | 687 | *  <em>Null character</em> is @c CharT() by definition.  For CharT | 
 
 
 
 
 | 688 | *  of @c char, this correctly writes the ASCII @c NUL character | 
 
 
 
 
 | 689 | *  string terminator. | 
 
 
 
 
 | 690 | */ | 
 
 
 
 
 | 691 | template<typename _CharT, typename _Traits> | 
 
 
 
 
 | 692 | inline basic_ostream<_CharT, _Traits>& | 
 
 
 
 
 | 693 | ends(basic_ostream<_CharT, _Traits>& __os) | 
 
 
 
 
 | 694 | { return __os.put(_CharT()); } | 
 
 
 
 
 | 695 |  | 
 
 
 
 
 | 696 | /** | 
 
 
 
 
 | 697 | *  @brief  Flushes the output stream. | 
 
 
 
 
 | 698 | * | 
 
 
 
 
 | 699 | *  This manipulator simply calls the stream's @c flush() member function. | 
 
 
 
 
 | 700 | */ | 
 
 
 
 
 | 701 | template<typename _CharT, typename _Traits> | 
 
 
 
 
 | 702 | inline basic_ostream<_CharT, _Traits>& | 
 
 
 
 
 | 703 | flush(basic_ostream<_CharT, _Traits>& __os) | 
 
 
 
 
 | 704 | { return __os.flush(); } | 
 
 
 
 
 | 705 |  | 
 
 
 
 
 | 706 | #if __cplusplus >= 201103L | 
 
 
 
 
 | 707 | // C++11 27.7.3.9 Rvalue stream insertion [ostream.rvalue] | 
 
 
 
 
 | 708 | // _GLIBCXX_RESOLVE_LIB_DEFECTS | 
 
 
 
 
 | 709 | // 1203. More useful rvalue stream insertion | 
 
 
 
 
 | 710 |  | 
 
 
 
 
 | 711 | #if __cpp_lib_concepts | 
 
 
 
 
 | 712 | // Use concepts if possible because they're cheaper to evaluate. | 
 
 
 
 
 | 713 | template<typename _Tp> | 
 
 
 
 
 | 714 | concept __derived_from_ios_base = is_class_v<_Tp> | 
 
 
 
 
 | 715 | && (!is_same_v<_Tp, ios_base>) | 
 
 
 
 
 | 716 | && requires (_Tp* __t, ios_base* __b) { __b = __t; }; | 
 
 
 
 
 | 717 |  | 
 
 
 
 
 | 718 | template<typename _Os, typename _Tp> | 
 
 
 
 
 | 719 | requires __derived_from_ios_base<_Os> | 
 
 
 
 
 | 720 | && requires (_Os& __os, const _Tp& __t) { __os << __t; } | 
 
 
 
 
 | 721 | using __rvalue_stream_insertion_t = _Os&&; | 
 
 
 
 
 | 722 | #else | 
 
 
 
 
 | 723 | template<typename _Tp> | 
 
 
 
 
 | 724 | using _Require_derived_from_ios_base | 
 
 
 
 
 | 725 | = _Require<is_class<_Tp>, __not_<is_same<_Tp, ios_base>>, | 
 
 
 
 
 | 726 | is_convertible<typename add_pointer<_Tp>::type, ios_base*>>; | 
 
 
 
 
 | 727 |  | 
 
 
 
 
 | 728 | template<typename _Os, typename _Tp, | 
 
 
 
 
 | 729 | typename = _Require_derived_from_ios_base<_Os>, | 
 
 
 
 
 | 730 | typename | 
 
 
 
 
 | 731 | = decltype(std::declval<_Os&>() << std::declval<const _Tp&>())> | 
 
 
 
 
 | 732 | using __rvalue_stream_insertion_t = _Os&&; | 
 
 
 
 
 | 733 | #endif | 
 
 
 
 
 | 734 |  | 
 
 
 
 
 | 735 | /** | 
 
 
 
 
 | 736 | *  @brief  Generic inserter for rvalue stream | 
 
 
 
 
 | 737 | *  @param  __os  An input stream. | 
 
 
 
 
 | 738 | *  @param  __x  A reference to the object being inserted. | 
 
 
 
 
 | 739 | *  @return  __os | 
 
 
 
 
 | 740 | * | 
 
 
 
 
 | 741 | *  This is just a forwarding function to allow insertion to | 
 
 
 
 
 | 742 | *  rvalue streams since they won't bind to the inserter functions | 
 
 
 
 
 | 743 | *  that take an lvalue reference. | 
 
 
 
 
 | 744 | */ | 
 
 
 
 
 | 745 | template<typename _Ostream, typename _Tp> | 
 
 
 
 
 | 746 | inline __rvalue_stream_insertion_t<_Ostream, _Tp> | 
 
 
 
 
 | 747 | operator<<(_Ostream&& __os, const _Tp& __x) | 
 
 
 
 
 | 748 | { | 
 
 
 
 
 | 749 | __os << __x; | 
 
 
 
 
 | 750 | return std::move(__os); | 
 
 
 
 
 | 751 | } | 
 
 
 
 
 | 752 |  | 
 
 
 
 
 | 753 | #if __cplusplus > 201703L && _GLIBCXX_USE_CXX11_ABI | 
 
 
 
 
 | 754 | template<typename _CharT, typename _Traits> | 
 
 
 
 
 | 755 | class __syncbuf_base : public basic_streambuf<_CharT, _Traits> | 
 
 
 
 
 | 756 | { | 
 
 
 
 
 | 757 | public: | 
 
 
 
 
 | 758 | static bool* | 
 
 
 
 
 | 759 | _S_get(basic_streambuf<_CharT, _Traits>* __buf [[maybe_unused]]) noexcept | 
 
 
 
 
 | 760 | { | 
 
 
 
 
 | 761 | #if __cpp_rtti | 
 
 
 
 
 | 762 | if (auto __p = dynamic_cast<__syncbuf_base*>(__buf)) | 
 
 
 
 
 | 763 | return &__p->_M_emit_on_sync; | 
 
 
 
 
 | 764 | #endif | 
 
 
 
 
 | 765 | return nullptr; | 
 
 
 
 
 | 766 | } | 
 
 
 
 
 | 767 |  | 
 
 
 
 
 | 768 | protected: | 
 
 
 
 
 | 769 | __syncbuf_base(basic_streambuf<_CharT, _Traits>* __w = nullptr) | 
 
 
 
 
 | 770 | : _M_wrapped(__w) | 
 
 
 
 
 | 771 | { } | 
 
 
 
 
 | 772 |  | 
 
 
 
 
 | 773 | basic_streambuf<_CharT, _Traits>* _M_wrapped = nullptr; | 
 
 
 
 
 | 774 | bool _M_emit_on_sync = false; | 
 
 
 
 
 | 775 | bool _M_needs_sync = false; | 
 
 
 
 
 | 776 | }; | 
 
 
 
 
 | 777 |  | 
 
 
 
 
 | 778 | template<typename _CharT, typename _Traits> | 
 
 
 
 
 | 779 | inline basic_ostream<_CharT, _Traits>& | 
 
 
 
 
 | 780 | emit_on_flush(basic_ostream<_CharT, _Traits>& __os) | 
 
 
 
 
 | 781 | { | 
 
 
 
 
 | 782 | if (bool* __flag = __syncbuf_base<_CharT, _Traits>::_S_get(__os.rdbuf())) | 
 
 
 
 
 | 783 | *__flag = true; | 
 
 
 
 
 | 784 | return __os; | 
 
 
 
 
 | 785 | } | 
 
 
 
 
 | 786 |  | 
 
 
 
 
 | 787 | template<typename _CharT, typename _Traits> | 
 
 
 
 
 | 788 | inline basic_ostream<_CharT, _Traits>& | 
 
 
 
 
 | 789 | noemit_on_flush(basic_ostream<_CharT, _Traits>& __os) | 
 
 
 
 
 | 790 | { | 
 
 
 
 
 | 791 | if (bool* __flag = __syncbuf_base<_CharT, _Traits>::_S_get(__os.rdbuf())) | 
 
 
 
 
 | 792 | *__flag = false; | 
 
 
 
 
 | 793 | return __os; | 
 
 
 
 
 | 794 | } | 
 
 
 
 
 | 795 |  | 
 
 
 
 
 | 796 | template<typename _CharT, typename _Traits> | 
 
 
 
 
 | 797 | inline basic_ostream<_CharT, _Traits>& | 
 
 
 
 
 | 798 | flush_emit(basic_ostream<_CharT, _Traits>& __os) | 
 
 
 
 
 | 799 | { | 
 
 
 
 
 | 800 | struct _Restore | 
 
 
 
 
 | 801 | { | 
 
 
 
 
 | 802 | ~_Restore() { *_M_flag = _M_prev; } | 
 
 
 
 
 | 803 |  | 
 
 
 
 
 | 804 | bool _M_prev = false; | 
 
 
 
 
 | 805 | bool* _M_flag = &_M_prev; | 
 
 
 
 
 | 806 | } __restore; | 
 
 
 
 
 | 807 |  | 
 
 
 
 
 | 808 | if (bool* __flag = __syncbuf_base<_CharT, _Traits>::_S_get(__os.rdbuf())) | 
 
 
 
 
 | 809 | { | 
 
 
 
 
 | 810 | __restore._M_prev = *__flag; | 
 
 
 
 
 | 811 | __restore._M_flag = __flag; | 
 
 
 
 
 | 812 | *__flag = true; | 
 
 
 
 
 | 813 | } | 
 
 
 
 
 | 814 |  | 
 
 
 
 
 | 815 | __os.flush(); | 
 
 
 
 
 | 816 | return __os; | 
 
 
 
 
 | 817 | } | 
 
 
 
 
 | 818 |  | 
 
 
 
 
 | 819 | #endif // C++20 | 
 
 
 
 
 | 820 |  | 
 
 
 
 
 | 821 | #endif // C++11 | 
 
 
 
 
 | 822 |  | 
 
 
 
 
 | 823 | _GLIBCXX_END_NAMESPACE_VERSION | 
 
 
 
 
 | 824 | } // namespace std | 
 
 
 
 
 | 825 |  | 
 
 
 
 
 | 826 | #include <bits/ostream.tcc> | 
 
 
 
 
 | 827 |  | 
 
 
 
 
 | 828 | #endif  /* _GLIBCXX_OSTREAM */ |