1// <string> Forward declarations -*- C++ -*-
2
3// Copyright (C) 2001-2024 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 bits/stringfwd.h
26 * This is an internal header file, included by other library headers.
27 * Do not attempt to use it directly. @headername{string}
28 */
29
30//
31// ISO C++ 14882: 21 Strings library
32//
33
34#ifndef _STRINGFWD_H
35#define _STRINGFWD_H 1
36
37#pragma GCC system_header
38
39#include <bits/c++config.h>
40#include <bits/memoryfwd.h>
41
42namespace std _GLIBCXX_VISIBILITY(default)
43{
44_GLIBCXX_BEGIN_NAMESPACE_VERSION
45
46 /**
47 * @defgroup strings Strings
48 *
49 * @{
50 */
51
52 template<class _CharT>
53 struct char_traits;
54
55 template<> struct char_traits<char>;
56
57 template<> struct char_traits<wchar_t>;
58
59#ifdef _GLIBCXX_USE_CHAR8_T
60 template<> struct char_traits<char8_t>;
61#endif
62
63#if __cplusplus >= 201103L
64 template<> struct char_traits<char16_t>;
65 template<> struct char_traits<char32_t>;
66#endif
67
68_GLIBCXX_BEGIN_NAMESPACE_CXX11
69
70 template<typename _CharT, typename _Traits = char_traits<_CharT>,
71 typename _Alloc = allocator<_CharT> >
72 class basic_string;
73
74_GLIBCXX_END_NAMESPACE_CXX11
75
76 /// A string of @c char
77 typedef basic_string<char> string;
78
79 /// A string of @c wchar_t
80 typedef basic_string<wchar_t> wstring;
81
82#ifdef _GLIBCXX_USE_CHAR8_T
83 /// A string of @c char8_t
84 typedef basic_string<char8_t> u8string;
85#endif
86
87#if __cplusplus >= 201103L
88 /// A string of @c char16_t
89 typedef basic_string<char16_t> u16string;
90
91 /// A string of @c char32_t
92 typedef basic_string<char32_t> u32string;
93#endif
94
95 /** @} */
96
97_GLIBCXX_END_NAMESPACE_VERSION
98} // namespace std
99
100#endif // _STRINGFWD_H
101