3 // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002
4 // Free Software Foundation, Inc.
6 // This file is part of the GNU ISO C++ Library. This library is free
7 // software; you can redistribute it and/or modify it under the
8 // terms of the GNU General Public License as published by the
9 // Free Software Foundation; either version 2, or (at your option)
12 // This library is distributed in the hope that it will be useful,
13 // but WITHOUT ANY WARRANTY; without even the implied warranty of
14 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 // GNU General Public License for more details.
17 // You should have received a copy of the GNU General Public License along
18 // with this library; see the file COPYING. If not, write to the Free
19 // Software Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307,
22 // As a special exception, you may use this file as part of a free software
23 // library without restriction. Specifically, if other files instantiate
24 // templates or use macros or inline functions from this file, or you compile
25 // this file and link it with other files to produce an executable, this
26 // file does not by itself cause the resulting executable to be covered by
27 // the GNU General Public License. This exception does not however
28 // invalidate any other reasons why the executable file might be covered by
29 // the GNU General Public License.
31 // XXX Should specialize copy, find algorithms for streambuf iterators.
33 /** @file streambuf_iterator.h
34 * This is an internal header file, included by other library headers.
35 * You should not attempt to use it directly.
38 #ifndef _CPP_BITS_STREAMBUF_ITERATOR_H
39 #define _CPP_BITS_STREAMBUF_ITERATOR_H 1
41 #pragma GCC system_header
45 // 24.5.3 Template class istreambuf_iterator
46 template<typename _CharT, typename _Traits>
47 class istreambuf_iterator
48 : public iterator<input_iterator_tag, _CharT, typename _Traits::off_type,
53 typedef _CharT char_type;
54 typedef _Traits traits_type;
55 typedef typename _Traits::int_type int_type;
56 typedef basic_streambuf<_CharT, _Traits> streambuf_type;
57 typedef basic_istream<_CharT, _Traits> istream_type;
60 // 24.5.3 istreambuf_iterator
62 // If the end of stream is reached (streambuf_type::sgetc()
63 // returns traits_type::eof()), the iterator becomes equal to
64 // the "end of stream" iterator value.
65 // NB: This implementation assumes the "end of stream" value
67 mutable streambuf_type* _M_sbuf;
71 istreambuf_iterator() throw()
72 : _M_sbuf(0), _M_c(-2) { }
74 istreambuf_iterator(istream_type& __s) throw()
75 : _M_sbuf(__s.rdbuf()), _M_c(-2) { }
77 istreambuf_iterator(streambuf_type* __s) throw()
78 : _M_sbuf(__s), _M_c(-2) { }
80 // NB: The result of operator*() on an end of stream is undefined.
83 { return traits_type::to_char_type(_M_get()); }
88 if (_M_sbuf && _M_sbuf->sbumpc() == traits_type::eof())
98 istreambuf_iterator __old = *this;
99 if (_M_sbuf && (__old._M_c = _M_sbuf->sbumpc()) == traits_type::eof())
106 #ifdef _GLIBCPP_RESOLVE_LIB_DEFECTS
107 // 110 istreambuf_iterator::equal not const
108 // NB: there is also number 111 (NAD, Future) pending on this function.
110 equal(const istreambuf_iterator& __b) const
112 const int_type __eof = traits_type::eof();
113 bool __thiseof = _M_get() == __eof;
114 bool __beof = __b._M_get() == __eof;
115 return (__thiseof && __beof || (!__thiseof && !__beof));
123 int_type __ret = traits_type::eof();
126 if (_M_c != static_cast<int_type>(-2))
129 if ((__ret = _M_sbuf->sgetc()) == traits_type::eof())
136 template<typename _CharT, typename _Traits>
138 operator==(const istreambuf_iterator<_CharT, _Traits>& __a,
139 const istreambuf_iterator<_CharT, _Traits>& __b)
140 { return __a.equal(__b); }
142 template<typename _CharT, typename _Traits>
144 operator!=(const istreambuf_iterator<_CharT, _Traits>& __a,
145 const istreambuf_iterator<_CharT, _Traits>& __b)
146 { return !__a.equal(__b); }
148 template<typename _CharT, typename _Traits>
149 class ostreambuf_iterator
150 : public iterator<output_iterator_tag, void, void, void, void>
154 typedef _CharT char_type;
155 typedef _Traits traits_type;
156 typedef basic_streambuf<_CharT, _Traits> streambuf_type;
157 typedef basic_ostream<_CharT, _Traits> ostream_type;
160 streambuf_type* _M_sbuf;
165 ostreambuf_iterator(ostream_type& __s) throw ()
166 : _M_sbuf(__s.rdbuf()), _M_failed(!_M_sbuf) { }
168 ostreambuf_iterator(streambuf_type* __s) throw ()
169 : _M_sbuf(__s), _M_failed(!_M_sbuf) { }
172 operator=(_CharT __c);
179 operator++(int) throw()
187 failed() const throw()
188 { return _M_failed; }
191 template<typename _CharT, typename _Traits>
192 inline ostreambuf_iterator<_CharT, _Traits>&
193 ostreambuf_iterator<_CharT, _Traits>::operator=(_CharT __c)
196 _Traits::eq_int_type(_M_sbuf->sputc(__c), _Traits::eof()))