libstdc++
iomanip
Go to the documentation of this file.
1 // Standard stream manipulators -*- C++ -*-
2 
3 // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005
4 // 2006, 2007, 2008, 2009, 2010
5 // Free Software Foundation, Inc.
6 //
7 // This file is part of the GNU ISO C++ Library. This library is free
8 // software; you can redistribute it and/or modify it under the
9 // terms of the GNU General Public License as published by the
10 // Free Software Foundation; either version 3, or (at your option)
11 // any later version.
12 
13 // This library is distributed in the hope that it will be useful,
14 // but WITHOUT ANY WARRANTY; without even the implied warranty of
15 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 // GNU General Public License for more details.
17 
18 // Under Section 7 of GPL version 3, you are granted additional
19 // permissions described in the GCC Runtime Library Exception, version
20 // 3.1, as published by the Free Software Foundation.
21 
22 // You should have received a copy of the GNU General Public License and
23 // a copy of the GCC Runtime Library Exception along with this program;
24 // see the files COPYING3 and COPYING.RUNTIME respectively. If not, see
25 // <http://www.gnu.org/licenses/>.
26 
27 /** @file include/iomanip
28  * This is a Standard C++ Library header.
29  */
30 
31 //
32 // ISO C++ 14882: 27.6.3 Standard manipulators
33 //
34 
35 #ifndef _GLIBCXX_IOMANIP
36 #define _GLIBCXX_IOMANIP 1
37 
38 #pragma GCC system_header
39 
40 #include <bits/c++config.h>
41 #include <iosfwd>
42 #include <bits/ios_base.h>
43 
44 #ifdef __GXX_EXPERIMENTAL_CXX0X__
45 #include <locale>
46 #endif
47 
48 namespace std _GLIBCXX_VISIBILITY(default)
49 {
50 _GLIBCXX_BEGIN_NAMESPACE_VERSION
51 
52  // [27.6.3] standard manipulators
53  // Also see DR 183.
54 
55  struct _Resetiosflags { ios_base::fmtflags _M_mask; };
56 
57  /**
58  * @brief Manipulator for @c setf.
59  * @param mask A format flags mask.
60  *
61  * Sent to a stream object, this manipulator resets the specified flags,
62  * via @e stream.setf(0,mask).
63  */
64  inline _Resetiosflags
65  resetiosflags(ios_base::fmtflags __mask)
66  { return { __mask }; }
67 
68  template<typename _CharT, typename _Traits>
69  inline basic_istream<_CharT, _Traits>&
70  operator>>(basic_istream<_CharT, _Traits>& __is, _Resetiosflags __f)
71  {
72  __is.setf(ios_base::fmtflags(0), __f._M_mask);
73  return __is;
74  }
75 
76  template<typename _CharT, typename _Traits>
77  inline basic_ostream<_CharT, _Traits>&
78  operator<<(basic_ostream<_CharT, _Traits>& __os, _Resetiosflags __f)
79  {
80  __os.setf(ios_base::fmtflags(0), __f._M_mask);
81  return __os;
82  }
83 
84 
85  struct _Setiosflags { ios_base::fmtflags _M_mask; };
86 
87  /**
88  * @brief Manipulator for @c setf.
89  * @param mask A format flags mask.
90  *
91  * Sent to a stream object, this manipulator sets the format flags
92  * to @a mask.
93  */
94  inline _Setiosflags
95  setiosflags(ios_base::fmtflags __mask)
96  { return { __mask }; }
97 
98  template<typename _CharT, typename _Traits>
99  inline basic_istream<_CharT, _Traits>&
100  operator>>(basic_istream<_CharT, _Traits>& __is, _Setiosflags __f)
101  {
102  __is.setf(__f._M_mask);
103  return __is;
104  }
105 
106  template<typename _CharT, typename _Traits>
107  inline basic_ostream<_CharT, _Traits>&
108  operator<<(basic_ostream<_CharT, _Traits>& __os, _Setiosflags __f)
109  {
110  __os.setf(__f._M_mask);
111  return __os;
112  }
113 
114 
115  struct _Setbase { int _M_base; };
116 
117  /**
118  * @brief Manipulator for @c setf.
119  * @param base A numeric base.
120  *
121  * Sent to a stream object, this manipulator changes the
122  * @c ios_base::basefield flags to @c oct, @c dec, or @c hex when @a base
123  * is 8, 10, or 16, accordingly, and to 0 if @a base is any other value.
124  */
125  inline _Setbase
127  { return { __base }; }
128 
129  template<typename _CharT, typename _Traits>
130  inline basic_istream<_CharT, _Traits>&
131  operator>>(basic_istream<_CharT, _Traits>& __is, _Setbase __f)
132  {
133  __is.setf(__f._M_base == 8 ? ios_base::oct :
134  __f._M_base == 10 ? ios_base::dec :
135  __f._M_base == 16 ? ios_base::hex :
137  return __is;
138  }
139 
140  template<typename _CharT, typename _Traits>
141  inline basic_ostream<_CharT, _Traits>&
142  operator<<(basic_ostream<_CharT, _Traits>& __os, _Setbase __f)
143  {
144  __os.setf(__f._M_base == 8 ? ios_base::oct :
145  __f._M_base == 10 ? ios_base::dec :
146  __f._M_base == 16 ? ios_base::hex :
148  return __os;
149  }
150 
151 
152  template<typename _CharT>
153  struct _Setfill { _CharT _M_c; };
154 
155  /**
156  * @brief Manipulator for @c fill.
157  * @param c The new fill character.
158  *
159  * Sent to a stream object, this manipulator calls @c fill(c) for that
160  * object.
161  */
162  template<typename _CharT>
163  inline _Setfill<_CharT>
164  setfill(_CharT __c)
165  { return { __c }; }
166 
167  template<typename _CharT, typename _Traits>
168  inline basic_istream<_CharT, _Traits>&
169  operator>>(basic_istream<_CharT, _Traits>& __is, _Setfill<_CharT> __f)
170  {
171  __is.fill(__f._M_c);
172  return __is;
173  }
174 
175  template<typename _CharT, typename _Traits>
176  inline basic_ostream<_CharT, _Traits>&
177  operator<<(basic_ostream<_CharT, _Traits>& __os, _Setfill<_CharT> __f)
178  {
179  __os.fill(__f._M_c);
180  return __os;
181  }
182 
183 
184  struct _Setprecision { int _M_n; };
185 
186  /**
187  * @brief Manipulator for @c precision.
188  * @param n The new precision.
189  *
190  * Sent to a stream object, this manipulator calls @c precision(n) for
191  * that object.
192  */
193  inline _Setprecision
194  setprecision(int __n)
195  { return { __n }; }
196 
197  template<typename _CharT, typename _Traits>
198  inline basic_istream<_CharT, _Traits>&
199  operator>>(basic_istream<_CharT, _Traits>& __is, _Setprecision __f)
200  {
201  __is.precision(__f._M_n);
202  return __is;
203  }
204 
205  template<typename _CharT, typename _Traits>
206  inline basic_ostream<_CharT, _Traits>&
207  operator<<(basic_ostream<_CharT, _Traits>& __os, _Setprecision __f)
208  {
209  __os.precision(__f._M_n);
210  return __os;
211  }
212 
213 
214  struct _Setw { int _M_n; };
215 
216  /**
217  * @brief Manipulator for @c width.
218  * @param n The new width.
219  *
220  * Sent to a stream object, this manipulator calls @c width(n) for
221  * that object.
222  */
223  inline _Setw
224  setw(int __n)
225  { return { __n }; }
226 
227  template<typename _CharT, typename _Traits>
228  inline basic_istream<_CharT, _Traits>&
229  operator>>(basic_istream<_CharT, _Traits>& __is, _Setw __f)
230  {
231  __is.width(__f._M_n);
232  return __is;
233  }
234 
235  template<typename _CharT, typename _Traits>
236  inline basic_ostream<_CharT, _Traits>&
237  operator<<(basic_ostream<_CharT, _Traits>& __os, _Setw __f)
238  {
239  __os.width(__f._M_n);
240  return __os;
241  }
242 
243 #ifdef __GXX_EXPERIMENTAL_CXX0X__
244 
245  template<typename _MoneyT>
246  struct _Get_money { _MoneyT& _M_mon; bool _M_intl; };
247 
248  /**
249  * @brief Extended manipulator for extracting money.
250  * @param mon Either long double or a specialization of @c basic_string.
251  * @param intl A bool indicating whether international format
252  * is to be used.
253  *
254  * Sent to a stream object, this manipulator extracts @a mon.
255  */
256  template<typename _MoneyT>
257  inline _Get_money<_MoneyT>
258  get_money(_MoneyT& __mon, bool __intl = false)
259  { return { __mon, __intl }; }
260 
261  template<typename _CharT, typename _Traits, typename _MoneyT>
262  basic_istream<_CharT, _Traits>&
263  operator>>(basic_istream<_CharT, _Traits>& __is, _Get_money<_MoneyT> __f)
264  {
265  typedef istreambuf_iterator<_CharT, _Traits> _Iter;
266  typedef money_get<_CharT, _Iter> _MoneyGet;
267 
269  const _MoneyGet& __mg = use_facet<_MoneyGet>(__is.getloc());
270 
271  __mg.get(_Iter(__is.rdbuf()), _Iter(), __f._M_intl,
272  __is, __err, __f._M_mon);
273 
274  if (ios_base::goodbit != __err)
275  __is.setstate(__err);
276 
277  return __is;
278  }
279 
280 
281  template<typename _MoneyT>
282  struct _Put_money { const _MoneyT& _M_mon; bool _M_intl; };
283 
284  /**
285  * @brief Extended manipulator for inserting money.
286  * @param mon Either long double or a specialization of @c basic_string.
287  * @param intl A bool indicating whether international format
288  * is to be used.
289  *
290  * Sent to a stream object, this manipulator inserts @a mon.
291  */
292  template<typename _MoneyT>
293  inline _Put_money<_MoneyT>
294  put_money(const _MoneyT& __mon, bool __intl = false)
295  { return { __mon, __intl }; }
296 
297  template<typename _CharT, typename _Traits, typename _MoneyT>
298  basic_ostream<_CharT, _Traits>&
299  operator<<(basic_ostream<_CharT, _Traits>& __os, _Put_money<_MoneyT> __f)
300  {
301  typedef ostreambuf_iterator<_CharT, _Traits> _Iter;
302  typedef money_put<_CharT, _Iter> _MoneyPut;
303 
304  const _MoneyPut& __mp = use_facet<_MoneyPut>(__os.getloc());
305  const _Iter __end = __mp.put(_Iter(__os.rdbuf()), __f._M_intl,
306  __os, __os.fill(), __f._M_mon);
307 
308  if (__end.failed())
309  __os.setstate(ios_base::badbit);
310 
311  return __os;
312  }
313 
314 #endif
315 
316  // Inhibit implicit instantiations for required instantiations,
317  // which are defined via explicit instantiations elsewhere.
318  // NB: This syntax is a GNU extension.
319 #if _GLIBCXX_EXTERN_TEMPLATE
320  extern template ostream& operator<<(ostream&, _Setfill<char>);
321  extern template ostream& operator<<(ostream&, _Setiosflags);
322  extern template ostream& operator<<(ostream&, _Resetiosflags);
323  extern template ostream& operator<<(ostream&, _Setbase);
324  extern template ostream& operator<<(ostream&, _Setprecision);
325  extern template ostream& operator<<(ostream&, _Setw);
326  extern template istream& operator>>(istream&, _Setfill<char>);
327  extern template istream& operator>>(istream&, _Setiosflags);
328  extern template istream& operator>>(istream&, _Resetiosflags);
329  extern template istream& operator>>(istream&, _Setbase);
330  extern template istream& operator>>(istream&, _Setprecision);
331  extern template istream& operator>>(istream&, _Setw);
332 
333 #ifdef _GLIBCXX_USE_WCHAR_T
334  extern template wostream& operator<<(wostream&, _Setfill<wchar_t>);
335  extern template wostream& operator<<(wostream&, _Setiosflags);
336  extern template wostream& operator<<(wostream&, _Resetiosflags);
337  extern template wostream& operator<<(wostream&, _Setbase);
338  extern template wostream& operator<<(wostream&, _Setprecision);
339  extern template wostream& operator<<(wostream&, _Setw);
340  extern template wistream& operator>>(wistream&, _Setfill<wchar_t>);
341  extern template wistream& operator>>(wistream&, _Setiosflags);
342  extern template wistream& operator>>(wistream&, _Resetiosflags);
343  extern template wistream& operator>>(wistream&, _Setbase);
344  extern template wistream& operator>>(wistream&, _Setprecision);
345  extern template wistream& operator>>(wistream&, _Setw);
346 #endif
347 #endif
348 
349 _GLIBCXX_END_NAMESPACE_VERSION
350 } // namespace
351 
352 #endif /* _GLIBCXX_IOMANIP */
static const fmtflags basefield
A mask of dec|oct|hex. Useful for the 2-arg form of setf.
Definition: ios_base.h:315
_Setiosflags setiosflags(ios_base::fmtflags __mask)
Manipulator for setf.
Definition: iomanip:95
bitset< _Nb > operator<<(size_t __position) const
Self-explanatory.
Definition: bitset:1332
bitset< _Nb > operator>>(size_t __position) const
Self-explanatory.
Definition: bitset:1336
static const iostate goodbit
Indicates all is well.
Definition: ios_base.h:347
_Resetiosflags resetiosflags(ios_base::fmtflags __mask)
Manipulator for setf.
Definition: iomanip:65
_Siter_base< _Iterator >::iterator_type __base(_Iterator __it)
_Setw setw(int __n)
Manipulator for width.
Definition: iomanip:224
static const fmtflags oct
Converts integer input or generates integer output in octal base.
Definition: ios_base.h:281
basic_istream< wchar_t > wistream
Base class for wchar_t input streams.
Definition: iosfwd:175
static const iostate badbit
Indicates a loss of integrity in an input or output sequence (such as an irrecoverable read error fro...
Definition: ios_base.h:336
_Ios_Iostate iostate
This is a bitmask type.
Definition: ios_base.h:332
_Ios_Fmtflags fmtflags
This is a bitmask type.
Definition: ios_base.h:257
_Setfill< _CharT > setfill(_CharT __c)
Manipulator for fill.
Definition: iomanip:164
_Get_money< _MoneyT > get_money(_MoneyT &__mon, bool __intl=false)
Extended manipulator for extracting money.
Definition: iomanip:258
_Setprecision setprecision(int __n)
Manipulator for precision.
Definition: iomanip:194
_Put_money< _MoneyT > put_money(const _MoneyT &__mon, bool __intl=false)
Extended manipulator for inserting money.
Definition: iomanip:294
basic_istream< char > istream
Base class for char input streams.
Definition: iosfwd:135
static const fmtflags dec
Converts integer input or generates integer output in decimal base.
Definition: ios_base.h:263
basic_ostream< wchar_t > wostream
Base class for wchar_t output streams.
Definition: iosfwd:178
basic_ostream< char > ostream
Base class for char output streams.
Definition: iosfwd:138
static const fmtflags hex
Converts integer input or generates integer output in hexadecimal base.
Definition: ios_base.h:269
_Setbase setbase(int __base)
Manipulator for setf.
Definition: iomanip:126