Where Online Learning is simpler!
The C and C++ Include Header Files
cat -n /usr/include/c++/15/codecvt
1 // <codecvt> -*- C++ -*- 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 // ISO C++ 14882: 22.5 Standard code conversion facets 26 27 /** @file include/codecvt 28 * This is a Standard C++ Library header. 29 */ 30 31 #ifndef _GLIBCXX_CODECVT 32 #define _GLIBCXX_CODECVT 1 33 34 #ifdef _GLIBCXX_SYSHDR 35 #pragma GCC system_header 36 #endif 37 38 #if __cplusplus < 201103L 39 # include <bits/c++0x_warning.h> 40 #else 41 42 #include <bits/locale_classes.h> 43 #include <bits/codecvt.h> 44 45 namespace std _GLIBCXX_VISIBILITY(default) 46 { 47 _GLIBCXX_BEGIN_NAMESPACE_VERSION 48 49 enum codecvt_mode 50 { 51 consume_header = 4, 52 generate_header = 2, 53 little_endian = 1 54 }; 55 56 template<typename _Elem, unsigned long _Maxcode = 0x10ffff, 57 codecvt_mode _Mode = (codecvt_mode)0> 58 class codecvt_utf8 : public codecvt<_Elem, char, mbstate_t> 59 { 60 public: 61 explicit 62 codecvt_utf8(size_t __refs = 0); 63 64 ~codecvt_utf8(); 65 }; 66 67 template<typename _Elem, unsigned long _Maxcode = 0x10ffff, 68 codecvt_mode _Mode = (codecvt_mode)0> 69 class codecvt_utf16 : public codecvt<_Elem, char, mbstate_t> 70 { 71 public: 72 explicit 73 codecvt_utf16(size_t __refs = 0); 74 75 ~codecvt_utf16(); 76 }; 77 78 template<typename _Elem, unsigned long _Maxcode = 0x10ffff, 79 codecvt_mode _Mode = (codecvt_mode)0> 80 class codecvt_utf8_utf16 : public codecvt<_Elem, char, mbstate_t> 81 { 82 public: 83 explicit 84 codecvt_utf8_utf16(size_t __refs = 0); 85 86 ~codecvt_utf8_utf16(); 87 }; 88 89 #define _GLIBCXX_CODECVT_SPECIALIZATION2(_NAME, _ELEM) \ 90 template<> \ 91 class _NAME<_ELEM> \ 92 : public codecvt<_ELEM, char, mbstate_t> \ 93 { \ 94 public: \ 95 typedef _ELEM intern_type; \ 96 typedef char extern_type; \ 97 typedef mbstate_t state_type; \ 98 \ 99 protected: \ 100 _NAME(unsigned long __maxcode, codecvt_mode __mode, size_t __refs) \ 101 : codecvt(__refs), _M_maxcode(__maxcode), _M_mode(__mode) { } \ 102 \ 103 virtual \ 104 ~_NAME(); \ 105 \ 106 virtual result \ 107 do_out(state_type& __state, const intern_type* __from, \ 108 const intern_type* __from_end, const intern_type*& __from_next, \ 109 extern_type* __to, extern_type* __to_end, \ 110 extern_type*& __to_next) const; \ 111 \ 112 virtual result \ 113 do_unshift(state_type& __state, \ 114 extern_type* __to, extern_type* __to_end, \ 115 extern_type*& __to_next) const; \ 116 \ 117 virtual result \ 118 do_in(state_type& __state, \ 119 const extern_type* __from, const extern_type* __from_end, \ 120 const extern_type*& __from_next, \ 121 intern_type* __to, intern_type* __to_end, \ 122 intern_type*& __to_next) const; \ 123 \ 124 virtual \ 125 int do_encoding() const throw(); \ 126 \ 127 virtual \ 128 bool do_always_noconv() const throw(); \ 129 \ 130 virtual \ 131 int do_length(state_type&, const extern_type* __from, \ 132 const extern_type* __end, size_t __max) const; \ 133 \ 134 virtual int \ 135 do_max_length() const throw(); \ 136 \ 137 private: \ 138 unsigned long _M_maxcode; \ 139 codecvt_mode _M_mode; \ 140 } 141 142 #define _GLIBCXX_CODECVT_SPECIALIZATION(_NAME, _ELEM) \ 143 _GLIBCXX_CODECVT_SPECIALIZATION2(__ ## _NAME ## _base, _ELEM); \ 144 template<unsigned long _Maxcode, codecvt_mode _Mode> \ 145 class _NAME<_ELEM, _Maxcode, _Mode> \ 146 : public __ ## _NAME ## _base<_ELEM> \ 147 { \ 148 public: \ 149 explicit \ 150 _NAME(size_t __refs = 0) \ 151 : __ ## _NAME ## _base<_ELEM>(std::min(_Maxcode, 0x10fffful), \ 152 _Mode, __refs) \ 153 { } \ 154 } 155 156 template<typename _Elem> class __codecvt_utf8_base; 157 template<typename _Elem> class __codecvt_utf16_base; 158 template<typename _Elem> class __codecvt_utf8_utf16_base; 159 160 _GLIBCXX_CODECVT_SPECIALIZATION(codecvt_utf8, char16_t); 161 _GLIBCXX_CODECVT_SPECIALIZATION(codecvt_utf16, char16_t); 162 _GLIBCXX_CODECVT_SPECIALIZATION(codecvt_utf8_utf16, char16_t); 163 164 _GLIBCXX_CODECVT_SPECIALIZATION(codecvt_utf8, char32_t); 165 _GLIBCXX_CODECVT_SPECIALIZATION(codecvt_utf16, char32_t); 166 _GLIBCXX_CODECVT_SPECIALIZATION(codecvt_utf8_utf16, char32_t); 167 168 #ifdef _GLIBCXX_USE_WCHAR_T 169 _GLIBCXX_CODECVT_SPECIALIZATION(codecvt_utf8, wchar_t); 170 _GLIBCXX_CODECVT_SPECIALIZATION(codecvt_utf16, wchar_t); 171 _GLIBCXX_CODECVT_SPECIALIZATION(codecvt_utf8_utf16, wchar_t); 172 #endif 173 174 _GLIBCXX_END_NAMESPACE_VERSION 175 } // namespace 176 177 #endif // C++11 178 179 #endif /* _GLIBCXX_CODECVT */
