1// Locale support (codecvt) -*- C++ -*-
2
3// Copyright (C) 2000-2019 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/codecvt.h
26 * This is an internal header file, included by other library headers.
27 * Do not attempt to use it directly. @headername{locale}
28 */
29
30//
31// ISO C++ 14882: 22.2.1.5 Template class codecvt
32//
33
34// Written by Benjamin Kosnik <bkoz@redhat.com>
35
36#ifndef _CODECVT_H
37#define _CODECVT_H 1
38
39#pragma GCC system_header
40
41namespace std _GLIBCXX_VISIBILITY(default)
42{
43_GLIBCXX_BEGIN_NAMESPACE_VERSION
44
45 /// Empty base class for codecvt facet [22.2.1.5].
46 class codecvt_base
47 {
48 public:
49 enum result
50 {
51 ok,
52 partial,
53 error,
54 noconv
55 };
56 };
57
58 /**
59 * @brief Common base for codecvt functions.
60 *
61 * This template class provides implementations of the public functions
62 * that forward to the protected virtual functions.
63 *
64 * This template also provides abstract stubs for the protected virtual
65 * functions.
66 */
67 template<typename _InternT, typename _ExternT, typename _StateT>
68 class __codecvt_abstract_base
69 : public locale::facet, public codecvt_base
70 {
71 public:
72 // Types:
73 typedef codecvt_base::result result;
74 typedef _InternT intern_type;
75 typedef _ExternT extern_type;
76 typedef _StateT state_type;
77
78 // 22.2.1.5.1 codecvt members
79 /**
80 * @brief Convert from internal to external character set.
81 *
82 * Converts input string of intern_type to output string of
83 * extern_type. This is analogous to wcsrtombs. It does this by
84 * calling codecvt::do_out.
85 *
86 * The source and destination character sets are determined by the
87 * facet's locale, internal and external types.
88 *
89 * The characters in [from,from_end) are converted and written to
90 * [to,to_end). from_next and to_next are set to point to the
91 * character following the last successfully converted character,
92 * respectively. If the result needed no conversion, from_next and
93 * to_next are not affected.
94 *
95 * The @a state argument should be initialized if the input is at the
96 * beginning and carried from a previous call if continuing
97 * conversion. There are no guarantees about how @a state is used.
98 *
99 * The result returned is a member of codecvt_base::result. If
100 * all the input is converted, returns codecvt_base::ok. If no
101 * conversion is necessary, returns codecvt_base::noconv. If
102 * the input ends early or there is insufficient space in the
103 * output, returns codecvt_base::partial. Otherwise the
104 * conversion failed and codecvt_base::error is returned.
105 *
106 * @param __state Persistent conversion state data.
107 * @param __from Start of input.
108 * @param __from_end End of input.
109 * @param __from_next Returns start of unconverted data.
110 * @param __to Start of output buffer.
111 * @param __to_end End of output buffer.
112 * @param __to_next Returns start of unused output area.
113 * @return codecvt_base::result.
114 */
115 result
116 out(state_type& __state, const intern_type* __from,
117 const intern_type* __from_end, const intern_type*& __from_next,
118 extern_type* __to, extern_type* __to_end,
119 extern_type*& __to_next) const
120 {
121 return this->do_out(__state, __from, __from_end, __from_next,
122 __to, __to_end, __to_next);
123 }
124
125 /**
126 * @brief Reset conversion state.
127 *
128 * Writes characters to output that would restore @a state to initial
129 * conditions. The idea is that if a partial conversion occurs, then
130 * the converting the characters written by this function would leave
131 * the state in initial conditions, rather than partial conversion
132 * state. It does this by calling codecvt::do_unshift().
133 *
134 * For example, if 4 external characters always converted to 1 internal
135 * character, and input to in() had 6 external characters with state
136 * saved, this function would write two characters to the output and
137 * set the state to initialized conditions.
138 *
139 * The source and destination character sets are determined by the
140 * facet's locale, internal and external types.
141 *
142 * The result returned is a member of codecvt_base::result. If the
143 * state could be reset and data written, returns codecvt_base::ok. If
144 * no conversion is necessary, returns codecvt_base::noconv. If the
145 * output has insufficient space, returns codecvt_base::partial.
146 * Otherwise the reset failed and codecvt_base::error is returned.
147 *
148 * @param __state Persistent conversion state data.
149 * @param __to Start of output buffer.
150 * @param __to_end End of output buffer.
151 * @param __to_next Returns start of unused output area.
152 * @return codecvt_base::result.
153 */
154 result
155 unshift(state_type& __state, extern_type* __to, extern_type* __to_end,
156 extern_type*& __to_next) const
157 { return this->do_unshift(__state, __to,__to_end,__to_next); }
158
159 /**
160 * @brief Convert from external to internal character set.
161 *
162 * Converts input string of extern_type to output string of
163 * intern_type. This is analogous to mbsrtowcs. It does this by
164 * calling codecvt::do_in.
165 *
166 * The source and destination character sets are determined by the
167 * facet's locale, internal and external types.
168 *
169 * The characters in [from,from_end) are converted and written to
170 * [to,to_end). from_next and to_next are set to point to the
171 * character following the last successfully converted character,
172 * respectively. If the result needed no conversion, from_next and
173 * to_next are not affected.
174 *
175 * The @a state argument should be initialized if the input is at the
176 * beginning and carried from a previous call if continuing
177 * conversion. There are no guarantees about how @a state is used.
178 *
179 * The result returned is a member of codecvt_base::result. If
180 * all the input is converted, returns codecvt_base::ok. If no
181 * conversion is necessary, returns codecvt_base::noconv. If
182 * the input ends early or there is insufficient space in the
183 * output, returns codecvt_base::partial. Otherwise the
184 * conversion failed and codecvt_base::error is returned.
185 *
186 * @param __state Persistent conversion state data.
187 * @param __from Start of input.
188 * @param __from_end End of input.
189 * @param __from_next Returns start of unconverted data.
190 * @param __to Start of output buffer.
191 * @param __to_end End of output buffer.
192 * @param __to_next Returns start of unused output area.
193 * @return codecvt_base::result.
194 */
195 result
196 in(state_type& __state, const extern_type* __from,
197 const extern_type* __from_end, const extern_type*& __from_next,
198 intern_type* __to, intern_type* __to_end,
199 intern_type*& __to_next) const
200 {
201 return this->do_in(__state, __from, __from_end, __from_next,
202 __to, __to_end, __to_next);
203 }
204
205 int
206 encoding() const throw()
207 { return this->do_encoding(); }
208
209 bool
210 always_noconv() const throw()
211 { return this->do_always_noconv(); }
212
213 int
214 length(state_type& __state, const extern_type* __from,
215 const extern_type* __end, size_t __max) const
216 { return this->do_length(__state, __from, __end, __max); }
217
218 int
219 max_length() const throw()
220 { return this->do_max_length(); }
221
222 protected:
223 explicit
224 __codecvt_abstract_base(size_t __refs = 0) : locale::facet(__refs) { }
225
226 virtual
227 ~__codecvt_abstract_base() { }
228
229 /**
230 * @brief Convert from internal to external character set.
231 *
232 * Converts input string of intern_type to output string of
233 * extern_type. This function is a hook for derived classes to change
234 * the value returned. @see out for more information.
235 */
236 virtual result
237 do_out(state_type& __state, const intern_type* __from,
238 const intern_type* __from_end, const intern_type*& __from_next,
239 extern_type* __to, extern_type* __to_end,
240 extern_type*& __to_next) const = 0;
241
242 virtual result
243 do_unshift(state_type& __state, extern_type* __to,
244 extern_type* __to_end, extern_type*& __to_next) const = 0;
245
246 virtual result
247 do_in(state_type& __state, const extern_type* __from,
248 const extern_type* __from_end, const extern_type*& __from_next,
249 intern_type* __to, intern_type* __to_end,
250 intern_type*& __to_next) const = 0;
251
252 virtual int
253 do_encoding() const throw() = 0;
254
255 virtual bool
256 do_always_noconv() const throw() = 0;
257
258 virtual int
259 do_length(state_type&, const extern_type* __from,
260 const extern_type* __end, size_t __max) const = 0;
261
262 virtual int
263 do_max_length() const throw() = 0;
264 };
265
266 /**
267 * @brief Primary class template codecvt.
268 * @ingroup locales
269 *
270 * NB: Generic, mostly useless implementation.
271 *
272 */
273 template<typename _InternT, typename _ExternT, typename _StateT>
274 class codecvt
275 : public __codecvt_abstract_base<_InternT, _ExternT, _StateT>
276 {
277 public:
278 // Types:
279 typedef codecvt_base::result result;
280 typedef _InternT intern_type;
281 typedef _ExternT extern_type;
282 typedef _StateT state_type;
283
284 protected:
285 __c_locale _M_c_locale_codecvt;
286
287 public:
288 static locale::id id;
289
290 explicit
291 codecvt(size_t __refs = 0)
292 : __codecvt_abstract_base<_InternT, _ExternT, _StateT> (__refs),
293 _M_c_locale_codecvt(0)
294 { }
295
296 explicit
297 codecvt(__c_locale __cloc, size_t __refs = 0);
298
299 protected:
300 virtual
301 ~codecvt() { }
302
303 virtual result
304 do_out(state_type& __state, const intern_type* __from,
305 const intern_type* __from_end, const intern_type*& __from_next,
306 extern_type* __to, extern_type* __to_end,
307 extern_type*& __to_next) const;
308
309 virtual result
310 do_unshift(state_type& __state, extern_type* __to,
311 extern_type* __to_end, extern_type*& __to_next) const;
312
313 virtual result
314 do_in(state_type& __state, const extern_type* __from,
315 const extern_type* __from_end, const extern_type*& __from_next,
316 intern_type* __to, intern_type* __to_end,
317 intern_type*& __to_next) const;
318
319 virtual int
320 do_encoding() const throw();
321
322 virtual bool
323 do_always_noconv() const throw();
324
325 virtual int
326 do_length(state_type&, const extern_type* __from,
327 const extern_type* __end, size_t __max) const;
328
329 virtual int
330 do_max_length() const throw();
331 };
332
333 template<typename _InternT, typename _ExternT, typename _StateT>
334 locale::id codecvt<_InternT, _ExternT, _StateT>::id;
335
336 /// class codecvt<char, char, mbstate_t> specialization.
337 template<>
338 class codecvt<char, char, mbstate_t>
339 : public __codecvt_abstract_base<char, char, mbstate_t>
340 {
341 friend class messages<char>;
342
343 public:
344 // Types:
345 typedef char intern_type;
346 typedef char extern_type;
347 typedef mbstate_t state_type;
348
349 protected:
350 __c_locale _M_c_locale_codecvt;
351
352 public:
353 static locale::id id;
354
355 explicit
356 codecvt(size_t __refs = 0);
357
358 explicit
359 codecvt(__c_locale __cloc, size_t __refs = 0);
360
361 protected:
362 virtual
363 ~codecvt();
364
365 virtual result
366 do_out(state_type& __state, const intern_type* __from,
367 const intern_type* __from_end, const intern_type*& __from_next,
368 extern_type* __to, extern_type* __to_end,
369 extern_type*& __to_next) const;
370
371 virtual result
372 do_unshift(state_type& __state, extern_type* __to,
373 extern_type* __to_end, extern_type*& __to_next) const;
374
375 virtual result
376 do_in(state_type& __state, const extern_type* __from,
377 const extern_type* __from_end, const extern_type*& __from_next,
378 intern_type* __to, intern_type* __to_end,
379 intern_type*& __to_next) const;
380
381 virtual int
382 do_encoding() const throw();
383
384 virtual bool
385 do_always_noconv() const throw();
386
387 virtual int
388 do_length(state_type&, const extern_type* __from,
389 const extern_type* __end, size_t __max) const;
390
391 virtual int
392 do_max_length() const throw();
393 };
394
395#ifdef _GLIBCXX_USE_WCHAR_T
396 /** @brief Class codecvt<wchar_t, char, mbstate_t> specialization.
397 *
398 * Converts between narrow and wide characters in the native character set
399 */
400 template<>
401 class codecvt<wchar_t, char, mbstate_t>
402 : public __codecvt_abstract_base<wchar_t, char, mbstate_t>
403 {
404 friend class messages<wchar_t>;
405
406 public:
407 // Types:
408 typedef wchar_t intern_type;
409 typedef char extern_type;
410 typedef mbstate_t state_type;
411
412 protected:
413 __c_locale _M_c_locale_codecvt;
414
415 public:
416 static locale::id id;
417
418 explicit
419 codecvt(size_t __refs = 0);
420
421 explicit
422 codecvt(__c_locale __cloc, size_t __refs = 0);
423
424 protected:
425 virtual
426 ~codecvt();
427
428 virtual result
429 do_out(state_type& __state, const intern_type* __from,
430 const intern_type* __from_end, const intern_type*& __from_next,
431 extern_type* __to, extern_type* __to_end,
432 extern_type*& __to_next) const;
433
434 virtual result
435 do_unshift(state_type& __state,
436 extern_type* __to, extern_type* __to_end,
437 extern_type*& __to_next) const;
438
439 virtual result
440 do_in(state_type& __state,
441 const extern_type* __from, const extern_type* __from_end,
442 const extern_type*& __from_next,
443 intern_type* __to, intern_type* __to_end,
444 intern_type*& __to_next) const;
445
446 virtual
447 int do_encoding() const throw();
448
449 virtual
450 bool do_always_noconv() const throw();
451
452 virtual
453 int do_length(state_type&, const extern_type* __from,
454 const extern_type* __end, size_t __max) const;
455
456 virtual int
457 do_max_length() const throw();
458 };
459#endif //_GLIBCXX_USE_WCHAR_T
460
461#if __cplusplus >= 201103L
462 /** @brief Class codecvt<char16_t, char, mbstate_t> specialization.
463 *
464 * Converts between UTF-16 and UTF-8.
465 */
466 template<>
467 class codecvt<char16_t, char, mbstate_t>
468 : public __codecvt_abstract_base<char16_t, char, mbstate_t>
469 {
470 public:
471 // Types:
472 typedef char16_t intern_type;
473 typedef char extern_type;
474 typedef mbstate_t state_type;
475
476 public:
477 static locale::id id;
478
479 explicit
480 codecvt(size_t __refs = 0)
481 : __codecvt_abstract_base<char16_t, char, mbstate_t>(__refs) { }
482
483 protected:
484 virtual
485 ~codecvt();
486
487 virtual result
488 do_out(state_type& __state, const intern_type* __from,
489 const intern_type* __from_end, const intern_type*& __from_next,
490 extern_type* __to, extern_type* __to_end,
491 extern_type*& __to_next) const;
492
493 virtual result
494 do_unshift(state_type& __state,
495 extern_type* __to, extern_type* __to_end,
496 extern_type*& __to_next) const;
497
498 virtual result
499 do_in(state_type& __state,
500 const extern_type* __from, const extern_type* __from_end,
501 const extern_type*& __from_next,
502 intern_type* __to, intern_type* __to_end,
503 intern_type*& __to_next) const;
504
505 virtual
506 int do_encoding() const throw();
507
508 virtual
509 bool do_always_noconv() const throw();
510
511 virtual
512 int do_length(state_type&, const extern_type* __from,
513 const extern_type* __end, size_t __max) const;
514
515 virtual int
516 do_max_length() const throw();
517 };
518
519 /** @brief Class codecvt<char32_t, char, mbstate_t> specialization.
520 *
521 * Converts between UTF-32 and UTF-8.
522 */
523 template<>
524 class codecvt<char32_t, char, mbstate_t>
525 : public __codecvt_abstract_base<char32_t, char, mbstate_t>
526 {
527 public:
528 // Types:
529 typedef char32_t intern_type;
530 typedef char extern_type;
531 typedef mbstate_t state_type;
532
533 public:
534 static locale::id id;
535
536 explicit
537 codecvt(size_t __refs = 0)
538 : __codecvt_abstract_base<char32_t, char, mbstate_t>(__refs) { }
539
540 protected:
541 virtual
542 ~codecvt();
543
544 virtual result
545 do_out(state_type& __state, const intern_type* __from,
546 const intern_type* __from_end, const intern_type*& __from_next,
547 extern_type* __to, extern_type* __to_end,
548 extern_type*& __to_next) const;
549
550 virtual result
551 do_unshift(state_type& __state,
552 extern_type* __to, extern_type* __to_end,
553 extern_type*& __to_next) const;
554
555 virtual result
556 do_in(state_type& __state,
557 const extern_type* __from, const extern_type* __from_end,
558 const extern_type*& __from_next,
559 intern_type* __to, intern_type* __to_end,
560 intern_type*& __to_next) const;
561
562 virtual
563 int do_encoding() const throw();
564
565 virtual
566 bool do_always_noconv() const throw();
567
568 virtual
569 int do_length(state_type&, const extern_type* __from,
570 const extern_type* __end, size_t __max) const;
571
572 virtual int
573 do_max_length() const throw();
574 };
575
576#ifdef _GLIBCXX_USE_CHAR8_T
577 /** @brief Class codecvt<char16_t, char8_t, mbstate_t> specialization.
578 *
579 * Converts between UTF-16 and UTF-8.
580 */
581 template<>
582 class codecvt<char16_t, char8_t, mbstate_t>
583 : public __codecvt_abstract_base<char16_t, char8_t, mbstate_t>
584 {
585 public:
586 // Types:
587 typedef char16_t intern_type;
588 typedef char8_t extern_type;
589 typedef mbstate_t state_type;
590
591 public:
592 static locale::id id;
593
594 explicit
595 codecvt(size_t __refs = 0)
596 : __codecvt_abstract_base<char16_t, char8_t, mbstate_t>(__refs) { }
597
598 protected:
599 virtual
600 ~codecvt();
601
602 virtual result
603 do_out(state_type& __state, const intern_type* __from,
604 const intern_type* __from_end, const intern_type*& __from_next,
605 extern_type* __to, extern_type* __to_end,
606 extern_type*& __to_next) const;
607
608 virtual result
609 do_unshift(state_type& __state,
610 extern_type* __to, extern_type* __to_end,
611 extern_type*& __to_next) const;
612
613 virtual result
614 do_in(state_type& __state,
615 const extern_type* __from, const extern_type* __from_end,
616 const extern_type*& __from_next,
617 intern_type* __to, intern_type* __to_end,
618 intern_type*& __to_next) const;
619
620 virtual
621 int do_encoding() const throw();
622
623 virtual
624 bool do_always_noconv() const throw();
625
626 virtual
627 int do_length(state_type&, const extern_type* __from,
628 const extern_type* __end, size_t __max) const;
629
630 virtual int
631 do_max_length() const throw();
632 };
633
634 /** @brief Class codecvt<char32_t, char8_t, mbstate_t> specialization.
635 *
636 * Converts between UTF-32 and UTF-8.
637 */
638 template<>
639 class codecvt<char32_t, char8_t, mbstate_t>
640 : public __codecvt_abstract_base<char32_t, char8_t, mbstate_t>
641 {
642 public:
643 // Types:
644 typedef char32_t intern_type;
645 typedef char8_t extern_type;
646 typedef mbstate_t state_type;
647
648 public:
649 static locale::id id;
650
651 explicit
652 codecvt(size_t __refs = 0)
653 : __codecvt_abstract_base<char32_t, char8_t, mbstate_t>(__refs) { }
654
655 protected:
656 virtual
657 ~codecvt();
658
659 virtual result
660 do_out(state_type& __state, const intern_type* __from,
661 const intern_type* __from_end, const intern_type*& __from_next,
662 extern_type* __to, extern_type* __to_end,
663 extern_type*& __to_next) const;
664
665 virtual result
666 do_unshift(state_type& __state,
667 extern_type* __to, extern_type* __to_end,
668 extern_type*& __to_next) const;
669
670 virtual result
671 do_in(state_type& __state,
672 const extern_type* __from, const extern_type* __from_end,
673 const extern_type*& __from_next,
674 intern_type* __to, intern_type* __to_end,
675 intern_type*& __to_next) const;
676
677 virtual
678 int do_encoding() const throw();
679
680 virtual
681 bool do_always_noconv() const throw();
682
683 virtual
684 int do_length(state_type&, const extern_type* __from,
685 const extern_type* __end, size_t __max) const;
686
687 virtual int
688 do_max_length() const throw();
689 };
690#endif // _GLIBCXX_USE_CHAR8_T
691
692#endif // C++11
693
694 /// class codecvt_byname [22.2.1.6].
695 template<typename _InternT, typename _ExternT, typename _StateT>
696 class codecvt_byname : public codecvt<_InternT, _ExternT, _StateT>
697 {
698 public:
699 explicit
700 codecvt_byname(const char* __s, size_t __refs = 0)
701 : codecvt<_InternT, _ExternT, _StateT>(__refs)
702 {
703 if (__builtin_strcmp(__s, "C") != 0
704 && __builtin_strcmp(__s, "POSIX") != 0)
705 {
706 this->_S_destroy_c_locale(this->_M_c_locale_codecvt);
707 this->_S_create_c_locale(this->_M_c_locale_codecvt, __s);
708 }
709 }
710
711#if __cplusplus >= 201103L
712 explicit
713 codecvt_byname(const string& __s, size_t __refs = 0)
714 : codecvt_byname(__s.c_str(), __refs) { }
715#endif
716
717 protected:
718 virtual
719 ~codecvt_byname() { }
720 };
721
722#if __cplusplus >= 201103L
723 template<>
724 class codecvt_byname<char16_t, char, mbstate_t>
725 : public codecvt<char16_t, char, mbstate_t>
726 {
727 public:
728 explicit
729 codecvt_byname(const char*, size_t __refs = 0)
730 : codecvt<char16_t, char, mbstate_t>(__refs) { }
731
732 explicit
733 codecvt_byname(const string& __s, size_t __refs = 0)
734 : codecvt_byname(__s.c_str(), __refs) { }
735
736 protected:
737 virtual
738 ~codecvt_byname() { }
739 };
740
741 template<>
742 class codecvt_byname<char32_t, char, mbstate_t>
743 : public codecvt<char32_t, char, mbstate_t>
744 {
745 public:
746 explicit
747 codecvt_byname(const char*, size_t __refs = 0)
748 : codecvt<char32_t, char, mbstate_t>(__refs) { }
749
750 explicit
751 codecvt_byname(const string& __s, size_t __refs = 0)
752 : codecvt_byname(__s.c_str(), __refs) { }
753
754 protected:
755 virtual
756 ~codecvt_byname() { }
757 };
758
759#if defined(_GLIBCXX_USE_CHAR8_T)
760 template<>
761 class codecvt_byname<char16_t, char8_t, mbstate_t>
762 : public codecvt<char16_t, char8_t, mbstate_t>
763 {
764 public:
765 explicit
766 codecvt_byname(const char* __s, size_t __refs = 0)
767 : codecvt<char16_t, char8_t, mbstate_t>(__refs) { }
768
769 explicit
770 codecvt_byname(const string& __s, size_t __refs = 0)
771 : codecvt_byname(__s.c_str(), __refs) { }
772
773 protected:
774 virtual
775 ~codecvt_byname() { }
776 };
777
778 template<>
779 class codecvt_byname<char32_t, char8_t, mbstate_t>
780 : public codecvt<char32_t, char8_t, mbstate_t>
781 {
782 public:
783 explicit
784 codecvt_byname(const char* __s, size_t __refs = 0)
785 : codecvt<char32_t, char8_t, mbstate_t>(__refs) { }
786
787 explicit
788 codecvt_byname(const string& __s, size_t __refs = 0)
789 : codecvt_byname(__s.c_str(), __refs) { }
790
791 protected:
792 virtual
793 ~codecvt_byname() { }
794 };
795#endif
796
797#endif // C++11
798
799 // Inhibit implicit instantiations for required instantiations,
800 // which are defined via explicit instantiations elsewhere.
801#if _GLIBCXX_EXTERN_TEMPLATE
802 extern template class codecvt_byname<char, char, mbstate_t>;
803
804 extern template
805 const codecvt<char, char, mbstate_t>&
806 use_facet<codecvt<char, char, mbstate_t> >(const locale&);
807
808 extern template
809 bool
810 has_facet<codecvt<char, char, mbstate_t> >(const locale&);
811
812#ifdef _GLIBCXX_USE_WCHAR_T
813 extern template class codecvt_byname<wchar_t, char, mbstate_t>;
814
815 extern template
816 const codecvt<wchar_t, char, mbstate_t>&
817 use_facet<codecvt<wchar_t, char, mbstate_t> >(const locale&);
818
819 extern template
820 bool
821 has_facet<codecvt<wchar_t, char, mbstate_t> >(const locale&);
822#endif
823
824#if __cplusplus >= 201103L
825 extern template class codecvt_byname<char16_t, char, mbstate_t>;
826 extern template class codecvt_byname<char32_t, char, mbstate_t>;
827
828#if defined(_GLIBCXX_USE_CHAR8_T)
829 extern template class codecvt_byname<char16_t, char8_t, mbstate_t>;
830 extern template class codecvt_byname<char32_t, char8_t, mbstate_t>;
831#endif
832
833#endif
834
835#endif
836
837_GLIBCXX_END_NAMESPACE_VERSION
838} // namespace std
839
840#endif // _CODECVT_H
841