libstdc++
iomanip
1 // Standard stream manipulators -*- C++ -*-
2 
3 // Copyright (C) 1997-2014 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/iomanip
26  * This is a Standard C++ Library header.
27  */
28 
29 //
30 // ISO C++ 14882: 27.6.3 Standard manipulators
31 //
32 
33 #ifndef _GLIBCXX_IOMANIP
34 #define _GLIBCXX_IOMANIP 1
35 
36 #pragma GCC system_header
37 
38 #include <bits/c++config.h>
39 #include <iosfwd>
40 #include <bits/ios_base.h>
41 
42 #if __cplusplus >= 201103L
43 #include <locale>
44 #if __cplusplus > 201103L
45 #include <sstream> // used in quoted.
46 #endif
47 #endif
48 
49 namespace std _GLIBCXX_VISIBILITY(default)
50 {
51 _GLIBCXX_BEGIN_NAMESPACE_VERSION
52 
53  // [27.6.3] standard manipulators
54  // Also see DR 183.
55 
56  struct _Resetiosflags { ios_base::fmtflags _M_mask; };
57 
58  /**
59  * @brief Manipulator for @c setf.
60  * @param __mask A format flags mask.
61  *
62  * Sent to a stream object, this manipulator resets the specified flags,
63  * via @e stream.setf(0,__mask).
64  */
65  inline _Resetiosflags
66  resetiosflags(ios_base::fmtflags __mask)
67  { return { __mask }; }
68 
69  template<typename _CharT, typename _Traits>
70  inline basic_istream<_CharT, _Traits>&
71  operator>>(basic_istream<_CharT, _Traits>& __is, _Resetiosflags __f)
72  {
73  __is.setf(ios_base::fmtflags(0), __f._M_mask);
74  return __is;
75  }
76 
77  template<typename _CharT, typename _Traits>
78  inline basic_ostream<_CharT, _Traits>&
79  operator<<(basic_ostream<_CharT, _Traits>& __os, _Resetiosflags __f)
80  {
81  __os.setf(ios_base::fmtflags(0), __f._M_mask);
82  return __os;
83  }
84 
85 
86  struct _Setiosflags { ios_base::fmtflags _M_mask; };
87 
88  /**
89  * @brief Manipulator for @c setf.
90  * @param __mask A format flags mask.
91  *
92  * Sent to a stream object, this manipulator sets the format flags
93  * to @a __mask.
94  */
95  inline _Setiosflags
96  setiosflags(ios_base::fmtflags __mask)
97  { return { __mask }; }
98 
99  template<typename _CharT, typename _Traits>
100  inline basic_istream<_CharT, _Traits>&
101  operator>>(basic_istream<_CharT, _Traits>& __is, _Setiosflags __f)
102  {
103  __is.setf(__f._M_mask);
104  return __is;
105  }
106 
107  template<typename _CharT, typename _Traits>
108  inline basic_ostream<_CharT, _Traits>&
109  operator<<(basic_ostream<_CharT, _Traits>& __os, _Setiosflags __f)
110  {
111  __os.setf(__f._M_mask);
112  return __os;
113  }
114 
115 
116  struct _Setbase { int _M_base; };
117 
118  /**
119  * @brief Manipulator for @c setf.
120  * @param __base A numeric base.
121  *
122  * Sent to a stream object, this manipulator changes the
123  * @c ios_base::basefield flags to @c oct, @c dec, or @c hex when @a base
124  * is 8, 10, or 16, accordingly, and to 0 if @a __base is any other value.
125  */
126  inline _Setbase
127  setbase(int __base)
128  { return { __base }; }
129 
130  template<typename _CharT, typename _Traits>
131  inline basic_istream<_CharT, _Traits>&
132  operator>>(basic_istream<_CharT, _Traits>& __is, _Setbase __f)
133  {
134  __is.setf(__f._M_base == 8 ? ios_base::oct :
135  __f._M_base == 10 ? ios_base::dec :
136  __f._M_base == 16 ? ios_base::hex :
137  ios_base::fmtflags(0), ios_base::basefield);
138  return __is;
139  }
140 
141  template<typename _CharT, typename _Traits>
142  inline basic_ostream<_CharT, _Traits>&
143  operator<<(basic_ostream<_CharT, _Traits>& __os, _Setbase __f)
144  {
145  __os.setf(__f._M_base == 8 ? ios_base::oct :
146  __f._M_base == 10 ? ios_base::dec :
147  __f._M_base == 16 ? ios_base::hex :
148  ios_base::fmtflags(0), ios_base::basefield);
149  return __os;
150  }
151 
152 
153  template<typename _CharT>
154  struct _Setfill { _CharT _M_c; };
155 
156  /**
157  * @brief Manipulator for @c fill.
158  * @param __c The new fill character.
159  *
160  * Sent to a stream object, this manipulator calls @c fill(__c) for that
161  * object.
162  */
163  template<typename _CharT>
164  inline _Setfill<_CharT>
165  setfill(_CharT __c)
166  { return { __c }; }
167 
168  template<typename _CharT, typename _Traits>
169  inline basic_istream<_CharT, _Traits>&
170  operator>>(basic_istream<_CharT, _Traits>& __is, _Setfill<_CharT> __f)
171  {
172  __is.fill(__f._M_c);
173  return __is;
174  }
175 
176  template<typename _CharT, typename _Traits>
177  inline basic_ostream<_CharT, _Traits>&
178  operator<<(basic_ostream<_CharT, _Traits>& __os, _Setfill<_CharT> __f)
179  {
180  __os.fill(__f._M_c);
181  return __os;
182  }
183 
184 
185  struct _Setprecision { int _M_n; };
186 
187  /**
188  * @brief Manipulator for @c precision.
189  * @param __n The new precision.
190  *
191  * Sent to a stream object, this manipulator calls @c precision(__n) for
192  * that object.
193  */
194  inline _Setprecision
195  setprecision(int __n)
196  { return { __n }; }
197 
198  template<typename _CharT, typename _Traits>
199  inline basic_istream<_CharT, _Traits>&
200  operator>>(basic_istream<_CharT, _Traits>& __is, _Setprecision __f)
201  {
202  __is.precision(__f._M_n);
203  return __is;
204  }
205 
206  template<typename _CharT, typename _Traits>
207  inline basic_ostream<_CharT, _Traits>&
208  operator<<(basic_ostream<_CharT, _Traits>& __os, _Setprecision __f)
209  {
210  __os.precision(__f._M_n);
211  return __os;
212  }
213 
214 
215  struct _Setw { int _M_n; };
216 
217  /**
218  * @brief Manipulator for @c width.
219  * @param __n The new width.
220  *
221  * Sent to a stream object, this manipulator calls @c width(__n) for
222  * that object.
223  */
224  inline _Setw
225  setw(int __n)
226  { return { __n }; }
227 
228  template<typename _CharT, typename _Traits>
229  inline basic_istream<_CharT, _Traits>&
230  operator>>(basic_istream<_CharT, _Traits>& __is, _Setw __f)
231  {
232  __is.width(__f._M_n);
233  return __is;
234  }
235 
236  template<typename _CharT, typename _Traits>
237  inline basic_ostream<_CharT, _Traits>&
238  operator<<(basic_ostream<_CharT, _Traits>& __os, _Setw __f)
239  {
240  __os.width(__f._M_n);
241  return __os;
242  }
243 
244 #if __cplusplus >= 201103L
245 
246  template<typename _MoneyT>
247  struct _Get_money { _MoneyT& _M_mon; bool _M_intl; };
248 
249  /**
250  * @brief Extended manipulator for extracting money.
251  * @param __mon Either long double or a specialization of @c basic_string.
252  * @param __intl A bool indicating whether international format
253  * is to be used.
254  *
255  * Sent to a stream object, this manipulator extracts @a __mon.
256  */
257  template<typename _MoneyT>
258  inline _Get_money<_MoneyT>
259  get_money(_MoneyT& __mon, bool __intl = false)
260  { return { __mon, __intl }; }
261 
262  template<typename _CharT, typename _Traits, typename _MoneyT>
263  basic_istream<_CharT, _Traits>&
264  operator>>(basic_istream<_CharT, _Traits>& __is, _Get_money<_MoneyT> __f)
265  {
266  typename basic_istream<_CharT, _Traits>::sentry __cerb(__is, false);
267  if (__cerb)
268  {
269  ios_base::iostate __err = ios_base::goodbit;
270  __try
271  {
272  typedef istreambuf_iterator<_CharT, _Traits> _Iter;
273  typedef money_get<_CharT, _Iter> _MoneyGet;
274 
275  const _MoneyGet& __mg = use_facet<_MoneyGet>(__is.getloc());
276  __mg.get(_Iter(__is.rdbuf()), _Iter(), __f._M_intl,
277  __is, __err, __f._M_mon);
278  }
279  __catch(__cxxabiv1::__forced_unwind&)
280  {
281  __is._M_setstate(ios_base::badbit);
282  __throw_exception_again;
283  }
284  __catch(...)
285  { __is._M_setstate(ios_base::badbit); }
286  if (__err)
287  __is.setstate(__err);
288  }
289  return __is;
290  }
291 
292 
293  template<typename _MoneyT>
294  struct _Put_money { const _MoneyT& _M_mon; bool _M_intl; };
295 
296  /**
297  * @brief Extended manipulator for inserting money.
298  * @param __mon Either long double or a specialization of @c basic_string.
299  * @param __intl A bool indicating whether international format
300  * is to be used.
301  *
302  * Sent to a stream object, this manipulator inserts @a __mon.
303  */
304  template<typename _MoneyT>
305  inline _Put_money<_MoneyT>
306  put_money(const _MoneyT& __mon, bool __intl = false)
307  { return { __mon, __intl }; }
308 
309  template<typename _CharT, typename _Traits, typename _MoneyT>
310  basic_ostream<_CharT, _Traits>&
311  operator<<(basic_ostream<_CharT, _Traits>& __os, _Put_money<_MoneyT> __f)
312  {
313  typename basic_ostream<_CharT, _Traits>::sentry __cerb(__os);
314  if (__cerb)
315  {
316  ios_base::iostate __err = ios_base::goodbit;
317  __try
318  {
319  typedef ostreambuf_iterator<_CharT, _Traits> _Iter;
320  typedef money_put<_CharT, _Iter> _MoneyPut;
321 
322  const _MoneyPut& __mp = use_facet<_MoneyPut>(__os.getloc());
323  if (__mp.put(_Iter(__os.rdbuf()), __f._M_intl, __os,
324  __os.fill(), __f._M_mon).failed())
325  __err |= ios_base::badbit;
326  }
327  __catch(__cxxabiv1::__forced_unwind&)
328  {
329  __os._M_setstate(ios_base::badbit);
330  __throw_exception_again;
331  }
332  __catch(...)
333  { __os._M_setstate(ios_base::badbit); }
334  if (__err)
335  __os.setstate(__err);
336  }
337  return __os;
338  }
339 
340 #if __cplusplus > 201103L
341 
342 _GLIBCXX_END_NAMESPACE_VERSION
343  namespace __detail {
344  _GLIBCXX_BEGIN_NAMESPACE_VERSION
345 
346  /**
347  * @brief Struct for delimited strings.
348  */
349  template<typename _String, typename _CharT>
350  struct _Quoted_string
351  {
352  static_assert(is_reference<_String>::value
353  || is_pointer<_String>::value,
354  "String type must be pointer or reference");
355 
356  _Quoted_string(_String __str, _CharT __del, _CharT __esc)
357  : _M_string(__str), _M_delim{__del}, _M_escape{__esc}
358  { }
359 
360  _Quoted_string&
361  operator=(_Quoted_string&) = delete;
362 
363  _String _M_string;
364  _CharT _M_delim;
365  _CharT _M_escape;
366  };
367 
368  /**
369  * @brief Inserter for quoted strings.
370  *
371  * _GLIBCXX_RESOLVE_LIB_DEFECTS
372  * DR 2344 quoted()'s interaction with padding is unclear
373  */
374  template<typename _CharT, typename _Traits>
375  auto&
376  operator<<(std::basic_ostream<_CharT, _Traits>& __os,
377  const _Quoted_string<const _CharT*, _CharT>& __str)
378  {
379  std::basic_ostringstream<_CharT, _Traits> __ostr;
380  __ostr << __str._M_delim;
381  for (const _CharT* __c = __str._M_string; *__c; ++__c)
382  {
383  if (*__c == __str._M_delim || *__c == __str._M_escape)
384  __ostr << __str._M_escape;
385  __ostr << *__c;
386  }
387  __ostr << __str._M_delim;
388 
389  return __os << __ostr.str();
390  }
391 
392  /**
393  * @brief Inserter for quoted strings.
394  *
395  * _GLIBCXX_RESOLVE_LIB_DEFECTS
396  * DR 2344 quoted()'s interaction with padding is unclear
397  */
398  template<typename _CharT, typename _Traits, typename _String>
399  auto&
400  operator<<(std::basic_ostream<_CharT, _Traits>& __os,
401  const _Quoted_string<_String, _CharT>& __str)
402  {
403  std::basic_ostringstream<_CharT, _Traits> __ostr;
404  __ostr << __str._M_delim;
405  for (auto& __c : __str._M_string)
406  {
407  if (__c == __str._M_delim || __c == __str._M_escape)
408  __ostr << __str._M_escape;
409  __ostr << __c;
410  }
411  __ostr << __str._M_delim;
412 
413  return __os << __ostr.str();
414  }
415 
416  /**
417  * @brief Extractor for delimited strings.
418  * The left and right delimiters can be different.
419  */
420  template<typename _CharT, typename _Traits, typename _Alloc>
421  auto&
422  operator>>(std::basic_istream<_CharT, _Traits>& __is,
423  const _Quoted_string<basic_string<_CharT, _Traits, _Alloc>&,
424  _CharT>& __str)
425  {
426  _CharT __c;
427  __is >> __c;
428  if (!__is.good())
429  return __is;
430  if (__c != __str._M_delim)
431  {
432  __is.unget();
433  __is >> __str._M_string;
434  return __is;
435  }
436  __str._M_string.clear();
437  std::ios_base::fmtflags __flags
438  = __is.flags(__is.flags() & ~std::ios_base::skipws);
439  do
440  {
441  __is >> __c;
442  if (!__is.good())
443  break;
444  if (__c == __str._M_escape)
445  {
446  __is >> __c;
447  if (!__is.good())
448  break;
449  }
450  else if (__c == __str._M_delim)
451  break;
452  __str._M_string += __c;
453  }
454  while (true);
455  __is.setf(__flags);
456 
457  return __is;
458  }
459  _GLIBCXX_END_NAMESPACE_VERSION
460  } // namespace __detail
461 _GLIBCXX_BEGIN_NAMESPACE_VERSION
462 
463  /**
464  * @brief Manipulator for quoted strings.
465  * @param __str String to quote.
466  * @param __delim Character to quote string with.
467  * @param __escape Escape character to escape itself or quote character.
468  */
469  template<typename _CharT>
470  inline auto
471  quoted(const _CharT* __string,
472  _CharT __delim = _CharT('"'), _CharT __escape = _CharT('\\'))
473  {
474  return __detail::_Quoted_string<const _CharT*, _CharT>(__string, __delim,
475  __escape);
476  }
477 
478  template<typename _CharT, typename _Traits, typename _Alloc>
479  inline auto
480  quoted(const basic_string<_CharT, _Traits, _Alloc>& __string,
481  _CharT __delim = _CharT('"'), _CharT __escape = _CharT('\\'))
482  {
483  return __detail::_Quoted_string<
484  const basic_string<_CharT, _Traits, _Alloc>&, _CharT>(
485  __string, __delim, __escape);
486  }
487 
488  template<typename _CharT, typename _Traits, typename _Alloc>
489  inline auto
490  quoted(basic_string<_CharT, _Traits, _Alloc>& __string,
491  _CharT __delim = _CharT('"'), _CharT __escape = _CharT('\\'))
492  {
493  return __detail::_Quoted_string<
494  basic_string<_CharT, _Traits, _Alloc>&, _CharT>(
495  __string, __delim, __escape);
496  }
497 
498 #endif // __cplusplus > 201103L
499 
500 #endif // __cplusplus >= 201103L
501 
502  // Inhibit implicit instantiations for required instantiations,
503  // which are defined via explicit instantiations elsewhere.
504  // NB: This syntax is a GNU extension.
505 #if _GLIBCXX_EXTERN_TEMPLATE
506  extern template ostream& operator<<(ostream&, _Setfill<char>);
507  extern template ostream& operator<<(ostream&, _Setiosflags);
508  extern template ostream& operator<<(ostream&, _Resetiosflags);
509  extern template ostream& operator<<(ostream&, _Setbase);
510  extern template ostream& operator<<(ostream&, _Setprecision);
511  extern template ostream& operator<<(ostream&, _Setw);
512  extern template istream& operator>>(istream&, _Setfill<char>);
513  extern template istream& operator>>(istream&, _Setiosflags);
514  extern template istream& operator>>(istream&, _Resetiosflags);
515  extern template istream& operator>>(istream&, _Setbase);
516  extern template istream& operator>>(istream&, _Setprecision);
517  extern template istream& operator>>(istream&, _Setw);
518 
519 #ifdef _GLIBCXX_USE_WCHAR_T
520  extern template wostream& operator<<(wostream&, _Setfill<wchar_t>);
521  extern template wostream& operator<<(wostream&, _Setiosflags);
522  extern template wostream& operator<<(wostream&, _Resetiosflags);
523  extern template wostream& operator<<(wostream&, _Setbase);
524  extern template wostream& operator<<(wostream&, _Setprecision);
525  extern template wostream& operator<<(wostream&, _Setw);
526  extern template wistream& operator>>(wistream&, _Setfill<wchar_t>);
527  extern template wistream& operator>>(wistream&, _Setiosflags);
528  extern template wistream& operator>>(wistream&, _Resetiosflags);
529  extern template wistream& operator>>(wistream&, _Setbase);
530  extern template wistream& operator>>(wistream&, _Setprecision);
531  extern template wistream& operator>>(wistream&, _Setw);
532 #endif
533 #endif
534 
535 _GLIBCXX_END_NAMESPACE_VERSION
536 } // namespace
537 
538 #endif /* _GLIBCXX_IOMANIP */