# iosfwd

Go to the documentation of this file.

    00001 // Forwarding declarations -*- C++ -*-
    00002
    00003 // Copyright (C) 1997, 1998, 1999, 2001, 2002, 2003
    00004 // Free Software Foundation, Inc.
    00005 //
    00006 // This file is part of the GNU ISO C++ Library.  This library is free
    00007 // software; you can redistribute it and/or modify it under the
    00008 // terms of the GNU General Public License as published by the
    00009 // Free Software Foundation; either version 2, or (at your option)
    00010 // any later version.
    00011
    00012 // This library is distributed in the hope that it will be useful,
    00013 // but WITHOUT ANY WARRANTY; without even the implied warranty of
    00014 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    00015 // GNU General Public License for more details.
    00016
    00017 // You should have received a copy of the GNU General Public License along
    00018 // with this library; see the file COPYING.  If not, write to the Free
    00019 // Software Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307,
    00020 // USA.
    00021
    00022 // As a special exception, you may use this file as part of a free software
    00023 // library without restriction.  Specifically, if other files instantiate
    00024 // templates or use macros or inline functions from this file, or you compile
    00025 // this file and link it with other files to produce an executable, this
    00026 // file does not by itself cause the resulting executable to be covered by
    00027 // the GNU General Public License.  This exception does not however
    00028 // invalidate any other reasons why the executable file might be covered by
    00029 // the GNU General Public License.
    00030
    00031 //
    00032 // ISO C++ 14882: 27.2  Forward declarations
    00033 //
    00034
    00035 /** @file iosfwd
    00036  *  This is a Standard C++ Library header.  You should @c #include this header
    00037  *  in your programs, rather than any of the "st[dl]_*.h" implementation files.
    00038  */
    00039
    00040 #ifndef _GLIBCXX_IOSFWD
    00041 #define _GLIBCXX_IOSFWD 1
    00042
    00043 #pragma GCC system_header
    00044
    00045 #include <bits/c++config.h>
    00046 #include <bits/c++locale.h>
    00047 #include <bits/c++io.h>
    00048 #include <cctype>       // For isspace, etc.
    00049 #include <bits/stringfwd.h>     // For string forward declarations.
    00050 #include <bits/postypes.h>
    00051 #include <bits/functexcept.h>
    00052
    00053 namespace std
    00054 {
    00055   template<typename _CharT, typename _Traits = char_traits<_CharT> >
    00056     class basic_ios;
    00057
    00058   template<typename _CharT, typename _Traits = char_traits<_CharT> >
    00059     class basic_streambuf;
    00060
    00061   template<typename _CharT, typename _Traits = char_traits<_CharT> >
    00062     class basic_istream;
    00063
    00064   template<typename _CharT, typename _Traits = char_traits<_CharT> >
    00065     class basic_ostream;
    00066
    00067   template<typename _CharT, typename _Traits = char_traits<_CharT> >
    00068     class basic_iostream;
    00069
    00070   template<typename _CharT, typename _Traits = char_traits<_CharT>,
    00071         typename _Alloc = allocator<_CharT> >
    00072     class basic_stringbuf;
    00073
    00074   template<typename _CharT, typename _Traits = char_traits<_CharT>,
    00075        typename _Alloc = allocator<_CharT> >
    00076     class basic_istringstream;
    00077
    00078   template<typename _CharT, typename _Traits = char_traits<_CharT>,
    00079        typename _Alloc = allocator<_CharT> >
    00080     class basic_ostringstream;
    00081
    00082   template<typename _CharT, typename _Traits = char_traits<_CharT>,
    00083        typename _Alloc = allocator<_CharT> >
    00084     class basic_stringstream;
    00085
    00086   template<typename _CharT, typename _Traits = char_traits<_CharT> >
    00087     class basic_filebuf;
    00088
    00089   template<typename _CharT, typename _Traits = char_traits<_CharT> >
    00090     class basic_ifstream;
    00091
    00092   template<typename _CharT, typename _Traits = char_traits<_CharT> >
    00093     class basic_ofstream;
    00094
    00095   template<typename _CharT, typename _Traits = char_traits<_CharT> >
    00096     class basic_fstream;
    00097
    00098   template<typename _CharT, typename _Traits = char_traits<_CharT> >
    00099     class istreambuf_iterator;
    00100
    00101   template<typename _CharT, typename _Traits = char_traits<_CharT> >
    00102     class ostreambuf_iterator;
    00103
    00104   // _GLIBCXX_RESOLVE_LIB_DEFECTS
    00105   // Not included.   (??? Apparently no LWG number?)
    00106   class ios_base;
    00107
    00108   /**
    00109    *  @defgroup s27_2_iosfwd I/O Forward Declarations
    00110    *
    00111    *  Nearly all of the I/O classes are parameterized on the type of
    00112    *  characters they read and write.  (The major exception is ios_base at
    00113    *  the top of the hierarchy.)  This is a change from pre-Standard
    00114    *  streams, which were not templates.
    00115    *
    00116    *  For ease of use and compatibility, all of the basic_* I/O-related
    00117    *  classes are given typedef names for both of the builtin character
    00118    *  widths (wide and narrow).  The typedefs are the same as the
    00119    *  pre-Standard names, for example:
    00120    *
    00121    *  @code
    00122    *     typedef basic_ifstream<char>  ifstream;
    00123    *  @endcode
    00124    *
    00125    *  Because properly forward-declaring these classes can be difficult, you
    00126    *  should not do it yourself.  Instead, include the &lt;iosfwd&gt;
    00127    *  header, which contains only declarations of all the I/O classes as
    00128    *  well as the typedefs.  Trying to forward-declare the typedefs
    00129    *  themselves (e.g., "class ostream;") is not valid ISO C++.
    00130    *
    00131    *  For more specific declarations, see
    00132    *  http://gcc.gnu.org/onlinedocs/libstdc++/27_io/howto.html#10
    00133    *
    00134    *  @{
    00135   */
    00136   typedef basic_ios<char>       ios;        ///< @isiosfwd
    00137   typedef basic_streambuf<char>     streambuf;  ///< @isiosfwd
    00138   typedef basic_istream<char>       istream;    ///< @isiosfwd
    00139   typedef basic_ostream<char>       ostream;    ///< @isiosfwd
    00140   typedef basic_iostream<char>      iostream;   ///< @isiosfwd
    00141   typedef basic_stringbuf<char>     stringbuf;  ///< @isiosfwd
    00142   typedef basic_istringstream<char>     istringstream;  ///< @isiosfwd
    00143   typedef basic_ostringstream<char>     ostringstream;  ///< @isiosfwd
    00144   typedef basic_stringstream<char>  stringstream;   ///< @isiosfwd
    00145   typedef basic_filebuf<char>       filebuf;    ///< @isiosfwd
    00146   typedef basic_ifstream<char>      ifstream;   ///< @isiosfwd
    00147   typedef basic_ofstream<char>      ofstream;   ///< @isiosfwd
    00148   typedef basic_fstream<char>       fstream;    ///< @isiosfwd
    00149
    00150 #ifdef _GLIBCXX_USE_WCHAR_T
    00151   typedef basic_ios<wchar_t>        wios;       ///< @isiosfwd
    00152   typedef basic_streambuf<wchar_t>  wstreambuf; ///< @isiosfwd
    00153   typedef basic_istream<wchar_t>    wistream;   ///< @isiosfwd
    00154   typedef basic_ostream<wchar_t>    wostream;   ///< @isiosfwd
    00155   typedef basic_iostream<wchar_t>   wiostream;  ///< @isiosfwd
    00156   typedef basic_stringbuf<wchar_t>  wstringbuf; ///< @isiosfwd
    00157   typedef basic_istringstream<wchar_t>  wistringstream; ///< @isiosfwd
    00158   typedef basic_ostringstream<wchar_t>  wostringstream; ///< @isiosfwd
    00159   typedef basic_stringstream<wchar_t>   wstringstream;  ///< @isiosfwd
    00160   typedef basic_filebuf<wchar_t>    wfilebuf;   ///< @isiosfwd
    00161   typedef basic_ifstream<wchar_t>   wifstream;  ///< @isiosfwd
    00162   typedef basic_ofstream<wchar_t>   wofstream;  ///< @isiosfwd
    00163   typedef basic_fstream<wchar_t>    wfstream;   ///< @isiosfwd
    00164 #endif
    00165   /** @}  */
    00166 } // namespace std
    00167
    00168 #endif /* _GLIBCXX_IOSFWD */