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
73namespace 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
94namespace 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