libstdc++
cuchar
Go to the documentation of this file.
1 // -*- C++ -*- forwarding header.
2 
3 // Copyright (C) 2015-2025 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/cuchar
26  * This is a Standard C++ Library file. You should @c \#include this file
27  * in your programs, rather than any of the @a *.h implementation files.
28  *
29  * This is the C++ version of the Standard C Library header @c uchar.h,
30  * and its contents are (mostly) the same as that header, but are all
31  * contained in the namespace @c std (except for names which are defined
32  * as macros in C).
33  */
34 
35 //
36 // ISO C++ 14882:2011 21.8
37 //
38 
39 #ifndef _GLIBCXX_CUCHAR
40 #define _GLIBCXX_CUCHAR 1
41 
42 #ifdef _GLIBCXX_SYSHDR
43 #pragma GCC system_header
44 #endif
45 
46 #if __cplusplus < 201103L
47 # include <bits/c++0x_warning.h>
48 #else
49 
50 #include <bits/c++config.h>
51 #include <cwchar>
52 
53 #if (_GLIBCXX_USE_C11_UCHAR_CXX11 \
54  || (_GLIBCXX_USE_CHAR8_T \
55  && (_GLIBCXX_USE_UCHAR_C8RTOMB_MBRTOC8_FCHAR8_T \
56  || (__cplusplus >= 202002 \
57  && _GLIBCXX_USE_UCHAR_C8RTOMB_MBRTOC8_CXX20))))
58 
59 #include <uchar.h>
60 
61 #endif
62 
63 
64 // Support for mbrtoc8 and c8rtomb is conditioned on support by the C library.
65 #if (_GLIBCXX_USE_CHAR8_T \
66  && (_GLIBCXX_USE_UCHAR_C8RTOMB_MBRTOC8_FCHAR8_T \
67  || (__cplusplus >= 202002 \
68  && _GLIBCXX_USE_UCHAR_C8RTOMB_MBRTOC8_CXX20)))
69 
70 #undef mbrtoc8
71 #undef c8rtomb
72 
73 namespace std _GLIBCXX_VISIBILITY(default)
74 {
75 _GLIBCXX_BEGIN_NAMESPACE_VERSION
76 
77  using ::mbrtoc8;
78  using ::c8rtomb;
79 
80 _GLIBCXX_END_NAMESPACE_VERSION
81 } // namespace std
82 
83 #endif // _GLIBCXX_USE_CHAR8_T
84 
85 
86 #if _GLIBCXX_USE_C11_UCHAR_CXX11
87 
88 // Get rid of those macros defined in <uchar.h> in lieu of real functions.
89 #undef mbrtoc16
90 #undef c16rtomb
91 #undef mbrtoc32
92 #undef c32rtomb
93 
94 namespace std _GLIBCXX_VISIBILITY(default)
95 {
96 _GLIBCXX_BEGIN_NAMESPACE_VERSION
97 
98  using ::mbrtoc16;
99  using ::c16rtomb;
100  using ::mbrtoc32;
101  using ::c32rtomb;
102 
103 _GLIBCXX_END_NAMESPACE_VERSION
104 } // namespace std
105 
106 #endif // _GLIBCXX_USE_C11_UCHAR_CXX11
107 
108 #endif // C++11
109 
110 #endif // _GLIBCXX_CUCHAR