3 // Copyright (C) 2001, 2004, 2005, 2009, 2010 Free Software Foundation, Inc.
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)
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.
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.
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/>.
25 /** @file bits/stream_iterator.h
26 * This is an internal header file, included by other library headers.
27 * Do not attempt to use it directly. @headername{iterator}
30 #ifndef _STREAM_ITERATOR_H
31 #define _STREAM_ITERATOR_H 1
33 #pragma GCC system_header
35 #include <debug/debug.h>
37 namespace std _GLIBCXX_VISIBILITY(default)
39 _GLIBCXX_BEGIN_NAMESPACE_VERSION
42 * @addtogroup iterators
46 /// Provides input iterator semantics for streams.
47 template<typename _Tp, typename _CharT = char,
48 typename _Traits = char_traits<_CharT>, typename _Dist = ptrdiff_t>
49 class istream_iterator
50 : public iterator<input_iterator_tag, _Tp, _Dist, const _Tp*, const _Tp&>
53 typedef _CharT char_type;
54 typedef _Traits traits_type;
55 typedef basic_istream<_CharT, _Traits> istream_type;
58 istream_type* _M_stream;
63 /// Construct end of input stream iterator.
64 _GLIBCXX_CONSTEXPR istream_iterator()
65 : _M_stream(0), _M_value(), _M_ok(false) {}
67 /// Construct start of input stream iterator.
68 istream_iterator(istream_type& __s)
72 istream_iterator(const istream_iterator& __obj)
73 : _M_stream(__obj._M_stream), _M_value(__obj._M_value),
80 __glibcxx_requires_cond(_M_ok,
81 _M_message(__gnu_debug::__msg_deref_istream)
87 operator->() const { return &(operator*()); }
92 __glibcxx_requires_cond(_M_ok,
93 _M_message(__gnu_debug::__msg_inc_istream)
102 __glibcxx_requires_cond(_M_ok,
103 _M_message(__gnu_debug::__msg_inc_istream)
104 ._M_iterator(*this));
105 istream_iterator __tmp = *this;
111 _M_equal(const istream_iterator& __x) const
112 { return (_M_ok == __x._M_ok) && (!_M_ok || _M_stream == __x._M_stream); }
118 _M_ok = (_M_stream && *_M_stream) ? true : false;
121 *_M_stream >> _M_value;
122 _M_ok = *_M_stream ? true : false;
127 /// Return true if x and y are both end or not end, or x and y are the same.
128 template<typename _Tp, typename _CharT, typename _Traits, typename _Dist>
130 operator==(const istream_iterator<_Tp, _CharT, _Traits, _Dist>& __x,
131 const istream_iterator<_Tp, _CharT, _Traits, _Dist>& __y)
132 { return __x._M_equal(__y); }
134 /// Return false if x and y are both end or not end, or x and y are the same.
135 template <class _Tp, class _CharT, class _Traits, class _Dist>
137 operator!=(const istream_iterator<_Tp, _CharT, _Traits, _Dist>& __x,
138 const istream_iterator<_Tp, _CharT, _Traits, _Dist>& __y)
139 { return !__x._M_equal(__y); }
142 * @brief Provides output iterator semantics for streams.
144 * This class provides an iterator to write to an ostream. The type Tp is
145 * the only type written by this iterator and there must be an
146 * operator<<(Tp) defined.
148 * @tparam _Tp The type to write to the ostream.
149 * @tparam _CharT The ostream char_type.
150 * @tparam _Traits The ostream char_traits.
152 template<typename _Tp, typename _CharT = char,
153 typename _Traits = char_traits<_CharT> >
154 class ostream_iterator
155 : public iterator<output_iterator_tag, void, void, void, void>
160 typedef _CharT char_type;
161 typedef _Traits traits_type;
162 typedef basic_ostream<_CharT, _Traits> ostream_type;
166 ostream_type* _M_stream;
167 const _CharT* _M_string;
170 /// Construct from an ostream.
171 ostream_iterator(ostream_type& __s) : _M_stream(&__s), _M_string(0) {}
174 * Construct from an ostream.
176 * The delimiter string @a c is written to the stream after every Tp
177 * written to the stream. The delimiter is not copied, and thus must
178 * not be destroyed while this iterator is in use.
180 * @param __s Underlying ostream to write to.
181 * @param __c CharT delimiter string to insert.
183 ostream_iterator(ostream_type& __s, const _CharT* __c)
184 : _M_stream(&__s), _M_string(__c) { }
186 /// Copy constructor.
187 ostream_iterator(const ostream_iterator& __obj)
188 : _M_stream(__obj._M_stream), _M_string(__obj._M_string) { }
190 /// Writes @a value to underlying ostream using operator<<. If
191 /// constructed with delimiter string, writes delimiter to ostream.
193 operator=(const _Tp& __value)
195 __glibcxx_requires_cond(_M_stream != 0,
196 _M_message(__gnu_debug::__msg_output_ostream)
197 ._M_iterator(*this));
198 *_M_stream << __value;
199 if (_M_string) *_M_stream << _M_string;
216 // @} group iterators
218 _GLIBCXX_END_NAMESPACE_VERSION