libstdc++-v3/include/std/iosfwd

   1 // Forwarding declarations -*- C++ -*-
   2
   3 // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005,
   4 // 2006, 2007, 2009
   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., "class ostream;") 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 */