libstdc++: iosfwd Source File

libstdc++

iosfwd
Go to the documentation of this file.
1// <iosfwd> Forward declarations -*- C++ -*-
2
3// Copyright (C) 1997-2026 Free Software Foundation, Inc.
4//
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)
9// any later version.
10
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.
15
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.
19
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/>.
24
25/** @file include/iosfwd
26 * This is a Standard C++ Library header.
27 */
28
29//
30// ISO C++ 14882: 27.2 Forward declarations
31//
32
33#ifndef _GLIBCXX_IOSFWD
34#define _GLIBCXX_IOSFWD 1
35
36#ifdef _GLIBCXX_SYSHDR
37#pragma GCC system_header
38#endif
39
40#include <bits/requires_hosted.h> // iostreams
41
42#define __glibcxx_want_spanstream
43#define __glibcxx_want_syncbuf
44#include <bits/version.h>
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 * ```
60 * typedef basic_ifstream<char> ifstream;
61 * ```
62 *
63 * Because properly forward-declaring these classes can be difficult, you
64 * should not do it yourself. Instead, include the `<iosfwd>`
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 * https://gcc.gnu.org/onlinedocs/libstdc++/manual/io.html#std.io.objects
71 */
72
73#include <bits/iosfwd_file.h>
74#include <bits/iosfwd_string.h>
75#include <bits/iosfwd_sync.h>
76#include <bits/iosfwd_span.h>
77
78#endif /* _GLIBCXX_IOSFWD */
iosfwd_file.h
iosfwd_span.h
iosfwd_string.h
iosfwd_sync.h
version.h
requires_hosted.h