1// Forwarding declarations -*- C++ -*-
2
3// Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005,
4// 2006, 2007, 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 iosfwd
28 *  This is a Standard C++ Library header.
29 */
30
31//
32// ISO C++ 14882: 27.2  Forward declarations
33//
34
35#ifndef _GLIBCXX_IOSFWD
36#define _GLIBCXX_IOSFWD 1
37
38#pragma GCC system_header
39
40#include <bits/c++config.h>
41#include <bits/stringfwd.h> 	// For string forward declarations.
42#include <bits/postypes.h>
43
44_GLIBCXX_BEGIN_NAMESPACE(std)
45
46  /** 
47   *  @defgroup io I/O
48   *
49   *  Nearly all of the I/O classes are parameterized on the type of
50   *  characters they read and write.  (The major exception is ios_base at
51   *  the top of the hierarchy.)  This is a change from pre-Standard
52   *  streams, which were not templates.
53   *
54   *  For ease of use and compatibility, all of the basic_* I/O-related
55   *  classes are given typedef names for both of the builtin character
56   *  widths (wide and narrow).  The typedefs are the same as the
57   *  pre-Standard names, for example:
58   *
59   *  @code
60   *     typedef basic_ifstream<char>  ifstream;
61   *  @endcode
62   *
63   *  Because properly forward-declaring these classes can be difficult, you
64   *  should not do it yourself.  Instead, include the &lt;iosfwd&gt;
65   *  header, which contains only declarations of all the I/O classes as
66   *  well as the typedefs.  Trying to forward-declare the typedefs
67   *  themselves (e.g., <code>class ostream;</code>) is not valid ISO C++.
68   *
69   *  For more specific declarations, see
70   *  http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt11ch24.html
71   *
72   *  @{
73  */
74  class ios_base; 
75
76  template<typename _CharT, typename _Traits = char_traits<_CharT> >
77    class basic_ios;
78
79  template<typename _CharT, typename _Traits = char_traits<_CharT> >
80    class basic_streambuf;
81
82  template<typename _CharT, typename _Traits = char_traits<_CharT> >
83    class basic_istream;
84
85  template<typename _CharT, typename _Traits = char_traits<_CharT> >
86    class basic_ostream;
87
88  template<typename _CharT, typename _Traits = char_traits<_CharT> >
89    class basic_iostream;
90
91  template<typename _CharT, typename _Traits = char_traits<_CharT>,
92	    typename _Alloc = allocator<_CharT> >
93    class basic_stringbuf;
94
95  template<typename _CharT, typename _Traits = char_traits<_CharT>,
96	   typename _Alloc = allocator<_CharT> >
97    class basic_istringstream;
98
99  template<typename _CharT, typename _Traits = char_traits<_CharT>,
100	   typename _Alloc = allocator<_CharT> >
101    class basic_ostringstream;
102
103  template<typename _CharT, typename _Traits = char_traits<_CharT>,
104	   typename _Alloc = allocator<_CharT> >
105    class basic_stringstream;
106
107  template<typename _CharT, typename _Traits = char_traits<_CharT> >
108    class basic_filebuf;
109
110  template<typename _CharT, typename _Traits = char_traits<_CharT> >
111    class basic_ifstream;
112
113  template<typename _CharT, typename _Traits = char_traits<_CharT> >
114    class basic_ofstream;
115
116  template<typename _CharT, typename _Traits = char_traits<_CharT> >
117    class basic_fstream;
118
119  template<typename _CharT, typename _Traits = char_traits<_CharT> >
120    class istreambuf_iterator;
121
122  template<typename _CharT, typename _Traits = char_traits<_CharT> >
123    class ostreambuf_iterator;
124
125  // _GLIBCXX_RESOLVE_LIB_DEFECTS
126  // Not included.   (??? Apparently no LWG number?)
127
128  typedef basic_ios<char> 		ios;		///< @isiosfwd
129  typedef basic_streambuf<char> 	streambuf;	///< @isiosfwd
130  typedef basic_istream<char> 		istream;	///< @isiosfwd
131  typedef basic_ostream<char> 		ostream;	///< @isiosfwd
132  typedef basic_iostream<char> 		iostream;	///< @isiosfwd
133  typedef basic_stringbuf<char> 	stringbuf;	///< @isiosfwd
134  typedef basic_istringstream<char> 	istringstream;	///< @isiosfwd
135  typedef basic_ostringstream<char> 	ostringstream;	///< @isiosfwd
136  typedef basic_stringstream<char> 	stringstream;	///< @isiosfwd
137  typedef basic_filebuf<char> 		filebuf;	///< @isiosfwd
138  typedef basic_ifstream<char> 		ifstream;	///< @isiosfwd
139  typedef basic_ofstream<char> 		ofstream;	///< @isiosfwd
140  typedef basic_fstream<char> 		fstream;	///< @isiosfwd
141
142#ifdef _GLIBCXX_USE_WCHAR_T
143  typedef basic_ios<wchar_t> 		wios;		///< @isiosfwd
144  typedef basic_streambuf<wchar_t> 	wstreambuf;	///< @isiosfwd
145  typedef basic_istream<wchar_t> 	wistream;	///< @isiosfwd
146  typedef basic_ostream<wchar_t> 	wostream;	///< @isiosfwd
147  typedef basic_iostream<wchar_t> 	wiostream;	///< @isiosfwd
148  typedef basic_stringbuf<wchar_t> 	wstringbuf;	///< @isiosfwd
149  typedef basic_istringstream<wchar_t> 	wistringstream;	///< @isiosfwd
150  typedef basic_ostringstream<wchar_t> 	wostringstream;	///< @isiosfwd
151  typedef basic_stringstream<wchar_t> 	wstringstream;	///< @isiosfwd
152  typedef basic_filebuf<wchar_t> 	wfilebuf;	///< @isiosfwd
153  typedef basic_ifstream<wchar_t> 	wifstream;	///< @isiosfwd
154  typedef basic_ofstream<wchar_t> 	wofstream;	///< @isiosfwd
155  typedef basic_fstream<wchar_t> 	wfstream;	///< @isiosfwd
156#endif
157  /** @}  */
158
159_GLIBCXX_END_NAMESPACE
160
161#endif /* _GLIBCXX_IOSFWD */
162