1 // Locale support -*- C++ -*-
3 // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004
4 // Free Software Foundation, Inc.
6 // This file is part of the GNU ISO C++ Library. This library is free
7 // software; you can redistribute it and/or modify it under the
8 // terms of the GNU General Public License as published by the
9 // Free Software Foundation; either version 2, or (at your option)
12 // This library is distributed in the hope that it will be useful,
13 // but WITHOUT ANY WARRANTY; without even the implied warranty of
14 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 // GNU General Public License for more details.
17 // You should have received a copy of the GNU General Public License along
18 // with this library; see the file COPYING. If not, write to the Free
19 // Software Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307,
22 // As a special exception, you may use this file as part of a free software
23 // library without restriction. Specifically, if other files instantiate
24 // templates or use macros or inline functions from this file, or you compile
25 // this file and link it with other files to produce an executable, this
26 // file does not by itself cause the resulting executable to be covered by
27 // the GNU General Public License. This exception does not however
28 // invalidate any other reasons why the executable file might be covered by
29 // the GNU General Public License.
32 // ISO C++ 14882: 22.1 Locales
35 /** @file locale_facets.h
36 * This is an internal header file, included by other library headers.
37 * You should not attempt to use it directly.
40 #ifndef _LOCALE_FACETS_H
41 #define _LOCALE_FACETS_H 1
43 #pragma GCC system_header
45 #include <ctime> // For struct tm
46 #include <cwctype> // For wctype_t
48 #include <bits/ios_base.h> // For ios_base, ios_base::iostate
53 // NB: Don't instantiate required wchar_t facets if no wchar_t support.
54 #ifdef _GLIBCXX_USE_WCHAR_T
55 # define _GLIBCXX_NUM_FACETS 28
57 # define _GLIBCXX_NUM_FACETS 14
60 // Convert string to numeric value of type _Tv and store results.
61 // NB: This is specialized for all required types, there is no
62 // generic definition.
63 template<typename _Tv>
65 __convert_to_v(const char* __in, _Tv& __out, ios_base::iostate& __err,
66 const __c_locale& __cloc);
68 // Explicit specializations for required types.
71 __convert_to_v(const char*, float&, ios_base::iostate&,
76 __convert_to_v(const char*, double&, ios_base::iostate&,
81 __convert_to_v(const char*, long double&, ios_base::iostate&,
84 // NB: __pad is a struct, rather than a function, so it can be
85 // partially-specialized.
86 template<typename _CharT, typename _Traits>
90 _S_pad(ios_base& __io, _CharT __fill, _CharT* __news,
91 const _CharT* __olds, const streamsize __newlen,
92 const streamsize __oldlen, const bool __num);
95 // Used by both numeric and monetary facets.
96 // Inserts "group separator" characters into an array of characters.
97 // It's recursive, one iteration per group. It moves the characters
98 // in the buffer this way: "xxxx12345" -> "12,345xxx". Call this
99 // only with __glen != 0.
100 template<typename _CharT>
102 __add_grouping(_CharT* __s, _CharT __sep,
103 const char* __gbeg, size_t __gsize,
104 const _CharT* __first, const _CharT* __last);
106 // This template permits specializing facet output code for
107 // ostreambuf_iterator. For ostreambuf_iterator, sputn is
108 // significantly more efficient than incrementing iterators.
109 template<typename _CharT>
111 ostreambuf_iterator<_CharT>
112 __write(ostreambuf_iterator<_CharT> __s, const _CharT* __ws, int __len)
114 __s._M_put(__ws, __len);
118 // This is the unspecialized form of the template.
119 template<typename _CharT, typename _OutIter>
122 __write(_OutIter __s, const _CharT* __ws, int __len)
124 for (int __j = 0; __j < __len; __j++, ++__s)
130 // 22.2.1.1 Template class ctype
131 // Include host and configuration specific ctype enums for ctype_base.
132 #include <bits/ctype_base.h>
134 // Common base for ctype<_CharT>.
136 * @brief Common base for ctype facet
138 * This template class provides implementations of the public functions
139 * that forward to the protected virtual functions.
141 * This template also provides abtract stubs for the protected virtual
144 template<typename _CharT>
145 class __ctype_abstract_base : public locale::facet, public ctype_base
149 /// Typedef for the template parameter
150 typedef _CharT char_type;
153 * @brief Test char_type classification.
155 * This function finds a mask M for @a c and compares it to mask @a m.
156 * It does so by returning the value of ctype<char_type>::do_is().
158 * @param c The char_type to compare the mask of.
159 * @param m The mask to compare against.
160 * @return (M & m) != 0.
163 is(mask __m, char_type __c) const
164 { return this->do_is(__m, __c); }
167 * @brief Return a mask array.
169 * This function finds the mask for each char_type in the range [lo,hi)
170 * and successively writes it to vec. vec must have as many elements
171 * as the char array. It does so by returning the value of
172 * ctype<char_type>::do_is().
174 * @param lo Pointer to start of range.
175 * @param hi Pointer to end of range.
176 * @param vec Pointer to an array of mask storage.
180 is(const char_type *__lo, const char_type *__hi, mask *__vec) const
181 { return this->do_is(__lo, __hi, __vec); }
184 * @brief Find char_type matching a mask
186 * This function searches for and returns the first char_type c in
187 * [lo,hi) for which is(m,c) is true. It does so by returning
188 * ctype<char_type>::do_scan_is().
190 * @param m The mask to compare against.
191 * @param lo Pointer to start of range.
192 * @param hi Pointer to end of range.
193 * @return Pointer to matching char_type if found, else @a hi.
196 scan_is(mask __m, const char_type* __lo, const char_type* __hi) const
197 { return this->do_scan_is(__m, __lo, __hi); }
200 * @brief Find char_type not matching a mask
202 * This function searches for and returns the first char_type c in
203 * [lo,hi) for which is(m,c) is false. It does so by returning
204 * ctype<char_type>::do_scan_not().
206 * @param m The mask to compare against.
207 * @param lo Pointer to first char in range.
208 * @param hi Pointer to end of range.
209 * @return Pointer to non-matching char if found, else @a hi.
212 scan_not(mask __m, const char_type* __lo, const char_type* __hi) const
213 { return this->do_scan_not(__m, __lo, __hi); }
216 * @brief Convert to uppercase.
218 * This function converts the argument to uppercase if possible.
219 * If not possible (for example, '2'), returns the argument. It does
220 * so by returning ctype<char_type>::do_toupper().
222 * @param c The char_type to convert.
223 * @return The uppercase char_type if convertible, else @a c.
226 toupper(char_type __c) const
227 { return this->do_toupper(__c); }
230 * @brief Convert array to uppercase.
232 * This function converts each char_type in the range [lo,hi) to
233 * uppercase if possible. Other elements remain untouched. It does so
234 * by returning ctype<char_type>:: do_toupper(lo, hi).
236 * @param lo Pointer to start of range.
237 * @param hi Pointer to end of range.
241 toupper(char_type *__lo, const char_type* __hi) const
242 { return this->do_toupper(__lo, __hi); }
245 * @brief Convert to lowercase.
247 * This function converts the argument to lowercase if possible. If
248 * not possible (for example, '2'), returns the argument. It does so
249 * by returning ctype<char_type>::do_tolower(c).
251 * @param c The char_type to convert.
252 * @return The lowercase char_type if convertible, else @a c.
255 tolower(char_type __c) const
256 { return this->do_tolower(__c); }
259 * @brief Convert array to lowercase.
261 * This function converts each char_type in the range [lo,hi) to
262 * lowercase if possible. Other elements remain untouched. It does so
263 * by returning ctype<char_type>:: do_tolower(lo, hi).
265 * @param lo Pointer to start of range.
266 * @param hi Pointer to end of range.
270 tolower(char_type* __lo, const char_type* __hi) const
271 { return this->do_tolower(__lo, __hi); }
274 * @brief Widen char to char_type
276 * This function converts the char argument to char_type using the
277 * simplest reasonable transformation. It does so by returning
278 * ctype<char_type>::do_widen(c).
280 * Note: this is not what you want for codepage conversions. See
283 * @param c The char to convert.
284 * @return The converted char_type.
287 widen(char __c) const
288 { return this->do_widen(__c); }
291 * @brief Widen array to char_type
293 * This function converts each char in the input to char_type using the
294 * simplest reasonable transformation. It does so by returning
295 * ctype<char_type>::do_widen(c).
297 * Note: this is not what you want for codepage conversions. See
300 * @param lo Pointer to start of range.
301 * @param hi Pointer to end of range.
302 * @param to Pointer to the destination array.
306 widen(const char* __lo, const char* __hi, char_type* __to) const
307 { return this->do_widen(__lo, __hi, __to); }
310 * @brief Narrow char_type to char
312 * This function converts the char_type to char using the simplest
313 * reasonable transformation. If the conversion fails, dfault is
314 * returned instead. It does so by returning
315 * ctype<char_type>::do_narrow(c).
317 * Note: this is not what you want for codepage conversions. See
320 * @param c The char_type to convert.
321 * @param dfault Char to return if conversion fails.
322 * @return The converted char.
325 narrow(char_type __c, char __dfault) const
326 { return this->do_narrow(__c, __dfault); }
329 * @brief Narrow array to char array
331 * This function converts each char_type in the input to char using the
332 * simplest reasonable transformation and writes the results to the
333 * destination array. For any char_type in the input that cannot be
334 * converted, @a dfault is used instead. It does so by returning
335 * ctype<char_type>::do_narrow(lo, hi, dfault, to).
337 * Note: this is not what you want for codepage conversions. See
340 * @param lo Pointer to start of range.
341 * @param hi Pointer to end of range.
342 * @param dfault Char to use if conversion fails.
343 * @param to Pointer to the destination array.
347 narrow(const char_type* __lo, const char_type* __hi,
348 char __dfault, char *__to) const
349 { return this->do_narrow(__lo, __hi, __dfault, __to); }
353 __ctype_abstract_base(size_t __refs = 0): facet(__refs) { }
356 ~__ctype_abstract_base() { }
359 * @brief Test char_type classification.
361 * This function finds a mask M for @a c and compares it to mask @a m.
363 * do_is() is a hook for a derived facet to change the behavior of
364 * classifying. do_is() must always return the same result for the
367 * @param c The char_type to find the mask of.
368 * @param m The mask to compare against.
369 * @return (M & m) != 0.
372 do_is(mask __m, char_type __c) const = 0;
375 * @brief Return a mask array.
377 * This function finds the mask for each char_type in the range [lo,hi)
378 * and successively writes it to vec. vec must have as many elements
381 * do_is() is a hook for a derived facet to change the behavior of
382 * classifying. do_is() must always return the same result for the
385 * @param lo Pointer to start of range.
386 * @param hi Pointer to end of range.
387 * @param vec Pointer to an array of mask storage.
390 virtual const char_type*
391 do_is(const char_type* __lo, const char_type* __hi,
392 mask* __vec) const = 0;
395 * @brief Find char_type matching mask
397 * This function searches for and returns the first char_type c in
398 * [lo,hi) for which is(m,c) is true.
400 * do_scan_is() is a hook for a derived facet to change the behavior of
401 * match searching. do_is() must always return the same result for the
404 * @param m The mask to compare against.
405 * @param lo Pointer to start of range.
406 * @param hi Pointer to end of range.
407 * @return Pointer to a matching char_type if found, else @a hi.
409 virtual const char_type*
410 do_scan_is(mask __m, const char_type* __lo,
411 const char_type* __hi) const = 0;
414 * @brief Find char_type not matching mask
416 * This function searches for and returns a pointer to the first
417 * char_type c of [lo,hi) for which is(m,c) is false.
419 * do_scan_is() is a hook for a derived facet to change the behavior of
420 * match searching. do_is() must always return the same result for the
423 * @param m The mask to compare against.
424 * @param lo Pointer to start of range.
425 * @param hi Pointer to end of range.
426 * @return Pointer to a non-matching char_type if found, else @a hi.
428 virtual const char_type*
429 do_scan_not(mask __m, const char_type* __lo,
430 const char_type* __hi) const = 0;
433 * @brief Convert to uppercase.
435 * This virtual function converts the char_type argument to uppercase
436 * if possible. If not possible (for example, '2'), returns the
439 * do_toupper() is a hook for a derived facet to change the behavior of
440 * uppercasing. do_toupper() must always return the same result for
443 * @param c The char_type to convert.
444 * @return The uppercase char_type if convertible, else @a c.
447 do_toupper(char_type) const = 0;
450 * @brief Convert array to uppercase.
452 * This virtual function converts each char_type in the range [lo,hi)
453 * to uppercase if possible. Other elements remain untouched.
455 * do_toupper() is a hook for a derived facet to change the behavior of
456 * uppercasing. do_toupper() must always return the same result for
459 * @param lo Pointer to start of range.
460 * @param hi Pointer to end of range.
463 virtual const char_type*
464 do_toupper(char_type* __lo, const char_type* __hi) const = 0;
467 * @brief Convert to lowercase.
469 * This virtual function converts the argument to lowercase if
470 * possible. If not possible (for example, '2'), returns the argument.
472 * do_tolower() is a hook for a derived facet to change the behavior of
473 * lowercasing. do_tolower() must always return the same result for
476 * @param c The char_type to convert.
477 * @return The lowercase char_type if convertible, else @a c.
480 do_tolower(char_type) const = 0;
483 * @brief Convert array to lowercase.
485 * This virtual function converts each char_type in the range [lo,hi)
486 * to lowercase if possible. Other elements remain untouched.
488 * do_tolower() is a hook for a derived facet to change the behavior of
489 * lowercasing. do_tolower() must always return the same result for
492 * @param lo Pointer to start of range.
493 * @param hi Pointer to end of range.
496 virtual const char_type*
497 do_tolower(char_type* __lo, const char_type* __hi) const = 0;
502 * This virtual function converts the char to char_type using the
503 * simplest reasonable transformation.
505 * do_widen() is a hook for a derived facet to change the behavior of
506 * widening. do_widen() must always return the same result for the
509 * Note: this is not what you want for codepage conversions. See
512 * @param c The char to convert.
513 * @return The converted char_type
516 do_widen(char) const = 0;
519 * @brief Widen char array
521 * This function converts each char in the input to char_type using the
522 * simplest reasonable transformation.
524 * do_widen() is a hook for a derived facet to change the behavior of
525 * widening. do_widen() must always return the same result for the
528 * Note: this is not what you want for codepage conversions. See
531 * @param lo Pointer to start range.
532 * @param hi Pointer to end of range.
533 * @param to Pointer to the destination array.
537 do_widen(const char* __lo, const char* __hi,
538 char_type* __dest) const = 0;
541 * @brief Narrow char_type to char
543 * This virtual function converts the argument to char using the
544 * simplest reasonable transformation. If the conversion fails, dfault
545 * is returned instead.
547 * do_narrow() is a hook for a derived facet to change the behavior of
548 * narrowing. do_narrow() must always return the same result for the
551 * Note: this is not what you want for codepage conversions. See
554 * @param c The char_type to convert.
555 * @param dfault Char to return if conversion fails.
556 * @return The converted char.
559 do_narrow(char_type, char __dfault) const = 0;
562 * @brief Narrow char_type array to char
564 * This virtual function converts each char_type in the range [lo,hi) to
565 * char using the simplest reasonable transformation and writes the
566 * results to the destination array. For any element in the input that
567 * cannot be converted, @a dfault is used instead.
569 * do_narrow() is a hook for a derived facet to change the behavior of
570 * narrowing. do_narrow() must always return the same result for the
573 * Note: this is not what you want for codepage conversions. See
576 * @param lo Pointer to start of range.
577 * @param hi Pointer to end of range.
578 * @param dfault Char to use if conversion fails.
579 * @param to Pointer to the destination array.
582 virtual const char_type*
583 do_narrow(const char_type* __lo, const char_type* __hi,
584 char __dfault, char* __dest) const = 0;
587 // NB: Generic, mostly useless implementation.
589 * @brief Template ctype facet
591 * This template class defines classification and conversion functions for
592 * character sets. It wraps <cctype> functionality. Ctype gets used by
593 * streams for many I/O operations.
595 * This template provides the protected virtual functions the developer
596 * will have to replace in a derived class or specialization to make a
597 * working facet. The public functions that access them are defined in
598 * __ctype_abstract_base, to allow for implementation flexibility. See
599 * ctype<wchar_t> for an example. The functions are documented in
600 * __ctype_abstract_base.
602 * Note: implementations are provided for all the protected virtual
603 * functions, but will likely not be useful.
605 template<typename _CharT>
606 class ctype : public __ctype_abstract_base<_CharT>
610 typedef _CharT char_type;
611 typedef typename __ctype_abstract_base<_CharT>::mask mask;
613 /// The facet id for ctype<char_type>
614 static locale::id id;
617 ctype(size_t __refs = 0) : __ctype_abstract_base<_CharT>(__refs) { }
624 do_is(mask __m, char_type __c) const;
626 virtual const char_type*
627 do_is(const char_type* __lo, const char_type* __hi, mask* __vec) const;
629 virtual const char_type*
630 do_scan_is(mask __m, const char_type* __lo, const char_type* __hi) const;
632 virtual const char_type*
633 do_scan_not(mask __m, const char_type* __lo,
634 const char_type* __hi) const;
637 do_toupper(char_type __c) const;
639 virtual const char_type*
640 do_toupper(char_type* __lo, const char_type* __hi) const;
643 do_tolower(char_type __c) const;
645 virtual const char_type*
646 do_tolower(char_type* __lo, const char_type* __hi) const;
649 do_widen(char __c) const;
652 do_widen(const char* __lo, const char* __hi, char_type* __dest) const;
655 do_narrow(char_type, char __dfault) const;
657 virtual const char_type*
658 do_narrow(const char_type* __lo, const char_type* __hi,
659 char __dfault, char* __dest) const;
662 template<typename _CharT>
663 locale::id ctype<_CharT>::id;
665 // 22.2.1.3 ctype<char> specialization.
667 * @brief The ctype<char> specialization.
669 * This class defines classification and conversion functions for
670 * the char type. It gets used by char streams for many I/O
671 * operations. The char specialization provides a number of
672 * optimizations as well.
675 class ctype<char> : public locale::facet, public ctype_base
679 /// Typedef for the template parameter char.
680 typedef char char_type;
684 __c_locale _M_c_locale_ctype;
686 __to_type _M_toupper;
687 __to_type _M_tolower;
688 const mask* _M_table;
689 mutable char _M_widen_ok;
690 mutable char _M_widen[1 + static_cast<unsigned char>(-1)];
691 mutable char _M_narrow[1 + static_cast<unsigned char>(-1)];
692 mutable char _M_narrow_ok; // 0 uninitialized, 1 init,
696 /// The facet id for ctype<char>
697 static locale::id id;
698 /// The size of the mask table. It is SCHAR_MAX + 1.
699 static const size_t table_size = 1 + static_cast<unsigned char>(-1);
702 * @brief Constructor performs initialization.
704 * This is the constructor provided by the standard.
706 * @param table If non-zero, table is used as the per-char mask.
707 * Else classic_table() is used.
708 * @param del If true, passes ownership of table to this facet.
709 * @param refs Passed to the base facet class.
712 ctype(const mask* __table = 0, bool __del = false, size_t __refs = 0);
715 * @brief Constructor performs static initialization.
717 * This constructor is used to construct the initial C locale facet.
719 * @param cloc Handle to C locale data.
720 * @param table If non-zero, table is used as the per-char mask.
721 * @param del If true, passes ownership of table to this facet.
722 * @param refs Passed to the base facet class.
725 ctype(__c_locale __cloc, const mask* __table = 0, bool __del = false,
729 * @brief Test char classification.
731 * This function compares the mask table[c] to @a m.
733 * @param c The char to compare the mask of.
734 * @param m The mask to compare against.
735 * @return True if m & table[c] is true, false otherwise.
738 is(mask __m, char __c) const;
741 * @brief Return a mask array.
743 * This function finds the mask for each char in the range [lo, hi) and
744 * successively writes it to vec. vec must have as many elements as
747 * @param lo Pointer to start of range.
748 * @param hi Pointer to end of range.
749 * @param vec Pointer to an array of mask storage.
753 is(const char* __lo, const char* __hi, mask* __vec) const;
756 * @brief Find char matching a mask
758 * This function searches for and returns the first char in [lo,hi) for
759 * which is(m,char) is true.
761 * @param m The mask to compare against.
762 * @param lo Pointer to start of range.
763 * @param hi Pointer to end of range.
764 * @return Pointer to a matching char if found, else @a hi.
767 scan_is(mask __m, const char* __lo, const char* __hi) const;
770 * @brief Find char not matching a mask
772 * This function searches for and returns a pointer to the first char
773 * in [lo,hi) for which is(m,char) is false.
775 * @param m The mask to compare against.
776 * @param lo Pointer to start of range.
777 * @param hi Pointer to end of range.
778 * @return Pointer to a non-matching char if found, else @a hi.
781 scan_not(mask __m, const char* __lo, const char* __hi) const;
784 * @brief Convert to uppercase.
786 * This function converts the char argument to uppercase if possible.
787 * If not possible (for example, '2'), returns the argument.
789 * toupper() acts as if it returns ctype<char>::do_toupper(c).
790 * do_toupper() must always return the same result for the same input.
792 * @param c The char to convert.
793 * @return The uppercase char if convertible, else @a c.
796 toupper(char_type __c) const
797 { return this->do_toupper(__c); }
800 * @brief Convert array to uppercase.
802 * This function converts each char in the range [lo,hi) to uppercase
803 * if possible. Other chars remain untouched.
805 * toupper() acts as if it returns ctype<char>:: do_toupper(lo, hi).
806 * do_toupper() must always return the same result for the same input.
808 * @param lo Pointer to first char in range.
809 * @param hi Pointer to end of range.
813 toupper(char_type *__lo, const char_type* __hi) const
814 { return this->do_toupper(__lo, __hi); }
817 * @brief Convert to lowercase.
819 * This function converts the char argument to lowercase if possible.
820 * If not possible (for example, '2'), returns the argument.
822 * tolower() acts as if it returns ctype<char>::do_tolower(c).
823 * do_tolower() must always return the same result for the same input.
825 * @param c The char to convert.
826 * @return The lowercase char if convertible, else @a c.
829 tolower(char_type __c) const
830 { return this->do_tolower(__c); }
833 * @brief Convert array to lowercase.
835 * This function converts each char in the range [lo,hi) to lowercase
836 * if possible. Other chars remain untouched.
838 * tolower() acts as if it returns ctype<char>:: do_tolower(lo, hi).
839 * do_tolower() must always return the same result for the same input.
841 * @param lo Pointer to first char in range.
842 * @param hi Pointer to end of range.
846 tolower(char_type* __lo, const char_type* __hi) const
847 { return this->do_tolower(__lo, __hi); }
852 * This function converts the char to char_type using the simplest
853 * reasonable transformation. For an underived ctype<char> facet, the
854 * argument will be returned unchanged.
856 * This function works as if it returns ctype<char>::do_widen(c).
857 * do_widen() must always return the same result for the same input.
859 * Note: this is not what you want for codepage conversions. See
862 * @param c The char to convert.
863 * @return The converted character.
866 widen(char __c) const
868 if (_M_widen_ok) return _M_widen[static_cast<unsigned char>(__c)];
869 this->_M_widen_init();
870 return this->do_widen(__c);
874 * @brief Widen char array
876 * This function converts each char in the input to char using the
877 * simplest reasonable transformation. For an underived ctype<char>
878 * facet, the argument will be copied unchanged.
880 * This function works as if it returns ctype<char>::do_widen(c).
881 * do_widen() must always return the same result for the same input.
883 * Note: this is not what you want for codepage conversions. See
886 * @param lo Pointer to first char in range.
887 * @param hi Pointer to end of range.
888 * @param to Pointer to the destination array.
892 widen(const char* __lo, const char* __hi, char_type* __to) const
894 if (_M_widen_ok == 1)
896 memcpy(__to, __lo, __hi - __lo);
899 if (!_M_widen_ok) _M_widen_init();
900 return this->do_widen(__lo, __hi, __to);
906 * This function converts the char to char using the simplest
907 * reasonable transformation. If the conversion fails, dfault is
908 * returned instead. For an underived ctype<char> facet, @a c
909 * will be returned unchanged.
911 * This function works as if it returns ctype<char>::do_narrow(c).
912 * do_narrow() must always return the same result for the same input.
914 * Note: this is not what you want for codepage conversions. See
917 * @param c The char to convert.
918 * @param dfault Char to return if conversion fails.
919 * @return The converted character.
922 narrow(char_type __c, char __dfault) const
924 if (_M_narrow[static_cast<unsigned char>(__c)])
925 return _M_narrow[static_cast<unsigned char>(__c)];
926 const char __t = do_narrow(__c, __dfault);
927 if (__t != __dfault) _M_narrow[static_cast<unsigned char>(__c)] = __t;
932 * @brief Narrow char array
934 * This function converts each char in the input to char using the
935 * simplest reasonable transformation and writes the results to the
936 * destination array. For any char in the input that cannot be
937 * converted, @a dfault is used instead. For an underived ctype<char>
938 * facet, the argument will be copied unchanged.
940 * This function works as if it returns ctype<char>::do_narrow(lo, hi,
941 * dfault, to). do_narrow() must always return the same result for the
944 * Note: this is not what you want for codepage conversions. See
947 * @param lo Pointer to start of range.
948 * @param hi Pointer to end of range.
949 * @param dfault Char to use if conversion fails.
950 * @param to Pointer to the destination array.
954 narrow(const char_type* __lo, const char_type* __hi,
955 char __dfault, char *__to) const
957 if (__builtin_expect(_M_narrow_ok == 1,true))
959 memcpy(__to, __lo, __hi - __lo);
964 return this->do_narrow(__lo, __hi, __dfault, __to);
968 /// Returns a pointer to the mask table provided to the constructor, or
969 /// the default from classic_table() if none was provided.
971 table() const throw()
974 /// Returns a pointer to the C locale mask table.
976 classic_table() throw();
981 * This function deletes table() if @a del was true in the
988 * @brief Convert to uppercase.
990 * This virtual function converts the char argument to uppercase if
991 * possible. If not possible (for example, '2'), returns the argument.
993 * do_toupper() is a hook for a derived facet to change the behavior of
994 * uppercasing. do_toupper() must always return the same result for
997 * @param c The char to convert.
998 * @return The uppercase char if convertible, else @a c.
1001 do_toupper(char_type) const;
1004 * @brief Convert array to uppercase.
1006 * This virtual function converts each char in the range [lo,hi) to
1007 * uppercase if possible. Other chars remain untouched.
1009 * do_toupper() is a hook for a derived facet to change the behavior of
1010 * uppercasing. do_toupper() must always return the same result for
1013 * @param lo Pointer to start of range.
1014 * @param hi Pointer to end of range.
1017 virtual const char_type*
1018 do_toupper(char_type* __lo, const char_type* __hi) const;
1021 * @brief Convert to lowercase.
1023 * This virtual function converts the char argument to lowercase if
1024 * possible. If not possible (for example, '2'), returns the argument.
1026 * do_tolower() is a hook for a derived facet to change the behavior of
1027 * lowercasing. do_tolower() must always return the same result for
1030 * @param c The char to convert.
1031 * @return The lowercase char if convertible, else @a c.
1034 do_tolower(char_type) const;
1037 * @brief Convert array to lowercase.
1039 * This virtual function converts each char in the range [lo,hi) to
1040 * lowercase if possible. Other chars remain untouched.
1042 * do_tolower() is a hook for a derived facet to change the behavior of
1043 * lowercasing. do_tolower() must always return the same result for
1046 * @param lo Pointer to first char in range.
1047 * @param hi Pointer to end of range.
1050 virtual const char_type*
1051 do_tolower(char_type* __lo, const char_type* __hi) const;
1056 * This virtual function converts the char to char using the simplest
1057 * reasonable transformation. For an underived ctype<char> facet, the
1058 * argument will be returned unchanged.
1060 * do_widen() is a hook for a derived facet to change the behavior of
1061 * widening. do_widen() must always return the same result for the
1064 * Note: this is not what you want for codepage conversions. See
1067 * @param c The char to convert.
1068 * @return The converted character.
1071 do_widen(char __c) const
1075 * @brief Widen char array
1077 * This function converts each char in the range [lo,hi) to char using
1078 * the simplest reasonable transformation. For an underived
1079 * ctype<char> facet, the argument will be copied unchanged.
1081 * do_widen() is a hook for a derived facet to change the behavior of
1082 * widening. do_widen() must always return the same result for the
1085 * Note: this is not what you want for codepage conversions. See
1088 * @param lo Pointer to start of range.
1089 * @param hi Pointer to end of range.
1090 * @param to Pointer to the destination array.
1094 do_widen(const char* __lo, const char* __hi, char_type* __dest) const
1096 memcpy(__dest, __lo, __hi - __lo);
1101 * @brief Narrow char
1103 * This virtual function converts the char to char using the simplest
1104 * reasonable transformation. If the conversion fails, dfault is
1105 * returned instead. For an underived ctype<char> facet, @a c will be
1106 * returned unchanged.
1108 * do_narrow() is a hook for a derived facet to change the behavior of
1109 * narrowing. do_narrow() must always return the same result for the
1112 * Note: this is not what you want for codepage conversions. See
1115 * @param c The char to convert.
1116 * @param dfault Char to return if conversion fails.
1117 * @return The converted char.
1120 do_narrow(char_type __c, char) const
1124 * @brief Narrow char array to char array
1126 * This virtual function converts each char in the range [lo,hi) to
1127 * char using the simplest reasonable transformation and writes the
1128 * results to the destination array. For any char in the input that
1129 * cannot be converted, @a dfault is used instead. For an underived
1130 * ctype<char> facet, the argument will be copied unchanged.
1132 * do_narrow() is a hook for a derived facet to change the behavior of
1133 * narrowing. do_narrow() must always return the same result for the
1136 * Note: this is not what you want for codepage conversions. See
1139 * @param lo Pointer to start of range.
1140 * @param hi Pointer to end of range.
1141 * @param dfault Char to use if conversion fails.
1142 * @param to Pointer to the destination array.
1145 virtual const char_type*
1146 do_narrow(const char_type* __lo, const char_type* __hi,
1147 char, char* __dest) const
1149 memcpy(__dest, __lo, __hi - __lo);
1155 void _M_widen_init() const
1157 char __tmp[sizeof(_M_widen)];
1158 for (size_t __i = 0; __i < sizeof(_M_widen); ++__i)
1160 do_widen(__tmp, __tmp + sizeof(__tmp), _M_widen);
1163 // Set _M_widen_ok to 2 if memcpy can't be used.
1164 for (size_t __i = 0; __i < sizeof(_M_widen); ++__i)
1165 if (__tmp[__i] != _M_widen[__i])
1172 // Fill in the narrowing cache and flag whether all values are
1173 // valid or not. _M_narrow_ok is set to 1 if the whole table is
1174 // narrowed, 2 if only some values could be narrowed.
1175 void _M_narrow_init() const
1177 char __tmp[sizeof(_M_narrow)];
1178 for (size_t __i = 0; __i < sizeof(_M_narrow); ++__i)
1180 do_narrow(__tmp, __tmp + sizeof(__tmp), 0, _M_narrow);
1182 // Check if any default values were created. Do this by
1183 // renarrowing with a different default value and comparing.
1184 bool __consecutive = true;
1185 for (size_t __i = 0; __i < sizeof(_M_narrow); ++__i)
1186 if (!_M_narrow[__i])
1189 do_narrow(__tmp + __i, __tmp + __i + 1, 1, &__c);
1192 __consecutive = false;
1196 _M_narrow_ok = __consecutive ? 1 : 2;
1202 use_facet<ctype<char> >(const locale& __loc);
1204 #ifdef _GLIBCXX_USE_WCHAR_T
1205 // 22.2.1.3 ctype<wchar_t> specialization
1207 * @brief The ctype<wchar_t> specialization.
1209 * This class defines classification and conversion functions for the
1210 * wchar_t type. It gets used by wchar_t streams for many I/O operations.
1211 * The wchar_t specialization provides a number of optimizations as well.
1213 * ctype<wchar_t> inherits its public methods from
1214 * __ctype_abstract_base<wchar_t>.
1217 class ctype<wchar_t> : public __ctype_abstract_base<wchar_t>
1221 /// Typedef for the template parameter wchar_t.
1222 typedef wchar_t char_type;
1223 typedef wctype_t __wmask_type;
1226 __c_locale _M_c_locale_ctype;
1228 // Pre-computed narrowed and widened chars.
1230 char _M_narrow[128];
1231 wint_t _M_widen[1 + static_cast<unsigned char>(-1)];
1233 // Pre-computed elements for do_is.
1235 __wmask_type _M_wmask[16];
1239 /// The facet id for ctype<wchar_t>
1240 static locale::id id;
1243 * @brief Constructor performs initialization.
1245 * This is the constructor provided by the standard.
1247 * @param refs Passed to the base facet class.
1250 ctype(size_t __refs = 0);
1253 * @brief Constructor performs static initialization.
1255 * This constructor is used to construct the initial C locale facet.
1257 * @param cloc Handle to C locale data.
1258 * @param refs Passed to the base facet class.
1261 ctype(__c_locale __cloc, size_t __refs = 0);
1265 _M_convert_to_wmask(const mask __m) const;
1272 * @brief Test wchar_t classification.
1274 * This function finds a mask M for @a c and compares it to mask @a m.
1276 * do_is() is a hook for a derived facet to change the behavior of
1277 * classifying. do_is() must always return the same result for the
1280 * @param c The wchar_t to find the mask of.
1281 * @param m The mask to compare against.
1282 * @return (M & m) != 0.
1285 do_is(mask __m, char_type __c) const;
1288 * @brief Return a mask array.
1290 * This function finds the mask for each wchar_t in the range [lo,hi)
1291 * and successively writes it to vec. vec must have as many elements
1294 * do_is() is a hook for a derived facet to change the behavior of
1295 * classifying. do_is() must always return the same result for the
1298 * @param lo Pointer to start of range.
1299 * @param hi Pointer to end of range.
1300 * @param vec Pointer to an array of mask storage.
1303 virtual const char_type*
1304 do_is(const char_type* __lo, const char_type* __hi, mask* __vec) const;
1307 * @brief Find wchar_t matching mask
1309 * This function searches for and returns the first wchar_t c in
1310 * [lo,hi) for which is(m,c) is true.
1312 * do_scan_is() is a hook for a derived facet to change the behavior of
1313 * match searching. do_is() must always return the same result for the
1316 * @param m The mask to compare against.
1317 * @param lo Pointer to start of range.
1318 * @param hi Pointer to end of range.
1319 * @return Pointer to a matching wchar_t if found, else @a hi.
1321 virtual const char_type*
1322 do_scan_is(mask __m, const char_type* __lo, const char_type* __hi) const;
1325 * @brief Find wchar_t not matching mask
1327 * This function searches for and returns a pointer to the first
1328 * wchar_t c of [lo,hi) for which is(m,c) is false.
1330 * do_scan_is() is a hook for a derived facet to change the behavior of
1331 * match searching. do_is() must always return the same result for the
1334 * @param m The mask to compare against.
1335 * @param lo Pointer to start of range.
1336 * @param hi Pointer to end of range.
1337 * @return Pointer to a non-matching wchar_t if found, else @a hi.
1339 virtual const char_type*
1340 do_scan_not(mask __m, const char_type* __lo,
1341 const char_type* __hi) const;
1344 * @brief Convert to uppercase.
1346 * This virtual function converts the wchar_t argument to uppercase if
1347 * possible. If not possible (for example, '2'), returns the argument.
1349 * do_toupper() is a hook for a derived facet to change the behavior of
1350 * uppercasing. do_toupper() must always return the same result for
1353 * @param c The wchar_t to convert.
1354 * @return The uppercase wchar_t if convertible, else @a c.
1357 do_toupper(char_type) const;
1360 * @brief Convert array to uppercase.
1362 * This virtual function converts each wchar_t in the range [lo,hi) to
1363 * uppercase if possible. Other elements remain untouched.
1365 * do_toupper() is a hook for a derived facet to change the behavior of
1366 * uppercasing. do_toupper() must always return the same result for
1369 * @param lo Pointer to start of range.
1370 * @param hi Pointer to end of range.
1373 virtual const char_type*
1374 do_toupper(char_type* __lo, const char_type* __hi) const;
1377 * @brief Convert to lowercase.
1379 * This virtual function converts the argument to lowercase if
1380 * possible. If not possible (for example, '2'), returns the argument.
1382 * do_tolower() is a hook for a derived facet to change the behavior of
1383 * lowercasing. do_tolower() must always return the same result for
1386 * @param c The wchar_t to convert.
1387 * @return The lowercase wchar_t if convertible, else @a c.
1390 do_tolower(char_type) const;
1393 * @brief Convert array to lowercase.
1395 * This virtual function converts each wchar_t in the range [lo,hi) to
1396 * lowercase if possible. Other elements remain untouched.
1398 * do_tolower() is a hook for a derived facet to change the behavior of
1399 * lowercasing. do_tolower() must always return the same result for
1402 * @param lo Pointer to start of range.
1403 * @param hi Pointer to end of range.
1406 virtual const char_type*
1407 do_tolower(char_type* __lo, const char_type* __hi) const;
1410 * @brief Widen char to wchar_t
1412 * This virtual function converts the char to wchar_t using the
1413 * simplest reasonable transformation. For an underived ctype<wchar_t>
1414 * facet, the argument will be cast to wchar_t.
1416 * do_widen() is a hook for a derived facet to change the behavior of
1417 * widening. do_widen() must always return the same result for the
1420 * Note: this is not what you want for codepage conversions. See
1423 * @param c The char to convert.
1424 * @return The converted wchar_t.
1427 do_widen(char) const;
1430 * @brief Widen char array to wchar_t array
1432 * This function converts each char in the input to wchar_t using the
1433 * simplest reasonable transformation. For an underived ctype<wchar_t>
1434 * facet, the argument will be copied, casting each element to wchar_t.
1436 * do_widen() is a hook for a derived facet to change the behavior of
1437 * widening. do_widen() must always return the same result for the
1440 * Note: this is not what you want for codepage conversions. See
1443 * @param lo Pointer to start range.
1444 * @param hi Pointer to end of range.
1445 * @param to Pointer to the destination array.
1449 do_widen(const char* __lo, const char* __hi, char_type* __dest) const;
1452 * @brief Narrow wchar_t to char
1454 * This virtual function converts the argument to char using
1455 * the simplest reasonable transformation. If the conversion
1456 * fails, dfault is returned instead. For an underived
1457 * ctype<wchar_t> facet, @a c will be cast to char and
1460 * do_narrow() is a hook for a derived facet to change the
1461 * behavior of narrowing. do_narrow() must always return the
1462 * same result for the same input.
1464 * Note: this is not what you want for codepage conversions. See
1467 * @param c The wchar_t to convert.
1468 * @param dfault Char to return if conversion fails.
1469 * @return The converted char.
1472 do_narrow(char_type, char __dfault) const;
1475 * @brief Narrow wchar_t array to char array
1477 * This virtual function converts each wchar_t in the range [lo,hi) to
1478 * char using the simplest reasonable transformation and writes the
1479 * results to the destination array. For any wchar_t in the input that
1480 * cannot be converted, @a dfault is used instead. For an underived
1481 * ctype<wchar_t> facet, the argument will be copied, casting each
1484 * do_narrow() is a hook for a derived facet to change the behavior of
1485 * narrowing. do_narrow() must always return the same result for the
1488 * Note: this is not what you want for codepage conversions. See
1491 * @param lo Pointer to start of range.
1492 * @param hi Pointer to end of range.
1493 * @param dfault Char to use if conversion fails.
1494 * @param to Pointer to the destination array.
1497 virtual const char_type*
1498 do_narrow(const char_type* __lo, const char_type* __hi,
1499 char __dfault, char* __dest) const;
1501 // For use at construction time only.
1503 _M_initialize_ctype();
1507 const ctype<wchar_t>&
1508 use_facet<ctype<wchar_t> >(const locale& __loc);
1509 #endif //_GLIBCXX_USE_WCHAR_T
1511 // Include host and configuration specific ctype inlines.
1512 #include <bits/ctype_inline.h>
1514 // 22.2.1.2 Template class ctype_byname
1515 template<typename _CharT>
1516 class ctype_byname : public ctype<_CharT>
1519 typedef _CharT char_type;
1522 ctype_byname(const char* __s, size_t __refs = 0);
1526 ~ctype_byname() { };
1529 // 22.2.1.4 Class ctype_byname specializations.
1531 ctype_byname<char>::ctype_byname(const char*, size_t refs);
1534 ctype_byname<wchar_t>::ctype_byname(const char*, size_t refs);
1536 // 22.2.1.5 Template class codecvt
1537 #include <bits/codecvt.h>
1539 // 22.2.2 The numeric category.
1543 // NB: Code depends on the order of _S_atoms_out elements.
1544 // Below are the indices into _S_atoms_out.
1552 _S_odigits_end = _S_odigits + 16,
1553 _S_oudigits = _S_odigits_end,
1554 _S_oudigits_end = _S_oudigits + 16,
1555 _S_oe = _S_odigits + 14, // For scientific notation, 'e'
1556 _S_oE = _S_oudigits + 14, // For scientific notation, 'E'
1557 _S_oend = _S_oudigits_end
1560 // A list of valid numeric literals for output. This array
1561 // contains chars that will be passed through the current locale's
1562 // ctype<_CharT>.widen() and then used to render numbers.
1563 // For the standard "C" locale, this is
1564 // "-+xX0123456789abcdef0123456789ABCDEF".
1565 static const char* _S_atoms_out;
1567 // String literal of acceptable (narrow) input, for num_get.
1568 // "-+xX0123456789abcdefABCDEF"
1569 static const char* _S_atoms_in;
1578 _S_ie = _S_izero + 14,
1579 _S_iE = _S_izero + 20,
1584 // Construct and return valid scanf format for floating point types.
1586 _S_format_float(const ios_base& __io, char* __fptr, char __mod);
1589 template<typename _CharT>
1590 struct __numpunct_cache : public locale::facet
1592 const char* _M_grouping;
1593 size_t _M_grouping_size;
1594 bool _M_use_grouping;
1595 const _CharT* _M_truename;
1596 size_t _M_truename_size;
1597 const _CharT* _M_falsename;
1598 size_t _M_falsename_size;
1599 _CharT _M_decimal_point;
1600 _CharT _M_thousands_sep;
1602 // A list of valid numeric literals for output: in the standard
1603 // "C" locale, this is "-+xX0123456789abcdef0123456789ABCDEF".
1604 // This array contains the chars after having been passed
1605 // through the current locale's ctype<_CharT>.widen().
1606 _CharT _M_atoms_out[__num_base::_S_oend];
1608 // A list of valid numeric literals for input: in the standard
1609 // "C" locale, this is "-+xX0123456789abcdefABCDEF"
1610 // This array contains the chars after having been passed
1611 // through the current locale's ctype<_CharT>.widen().
1612 _CharT _M_atoms_in[__num_base::_S_iend];
1616 __numpunct_cache(size_t __refs = 0) : facet(__refs),
1617 _M_grouping(NULL), _M_grouping_size(0), _M_use_grouping(false),
1618 _M_truename(NULL), _M_truename_size(0), _M_falsename(NULL),
1619 _M_falsename_size(0), _M_decimal_point(_CharT()),
1620 _M_thousands_sep(_CharT()), _M_allocated(false)
1623 ~__numpunct_cache();
1626 _M_cache(const locale& __loc);
1629 template<typename _CharT>
1630 __numpunct_cache<_CharT>::~__numpunct_cache()
1634 delete [] _M_grouping;
1635 delete [] _M_truename;
1636 delete [] _M_falsename;
1641 * @brief Numpunct facet.
1643 * This facet stores several pieces of information related to printing and
1644 * scanning numbers, such as the decimal point character. It takes a
1645 * template parameter specifying the char type. The numpunct facet is
1646 * used by streams for many I/O operations involving numbers.
1648 * The numpunct template uses protected virtual functions to provide the
1649 * actual results. The public accessors forward the call to the virtual
1650 * functions. These virtual functions are hooks for developers to
1651 * implement the behavior they require from a numpunct facet.
1653 template<typename _CharT>
1654 class numpunct : public locale::facet
1660 typedef _CharT char_type;
1661 typedef basic_string<_CharT> string_type;
1663 typedef __numpunct_cache<_CharT> __cache_type;
1666 __cache_type* _M_data;
1669 /// Numpunct facet id.
1670 static locale::id id;
1673 * @brief Numpunct constructor.
1675 * @param refs Refcount to pass to the base class.
1678 numpunct(size_t __refs = 0) : facet(__refs), _M_data(NULL)
1679 { _M_initialize_numpunct(); }
1682 * @brief Internal constructor. Not for general use.
1684 * This is a constructor for use by the library itself to set up the
1685 * predefined locale facets.
1687 * @param cache __numpunct_cache object.
1688 * @param refs Refcount to pass to the base class.
1691 numpunct(__cache_type* __cache, size_t __refs = 0)
1692 : facet(__refs), _M_data(__cache)
1693 { _M_initialize_numpunct(); }
1696 * @brief Internal constructor. Not for general use.
1698 * This is a constructor for use by the library itself to set up new
1701 * @param cloc The "C" locale.
1702 * @param refs Refcount to pass to the base class.
1705 numpunct(__c_locale __cloc, size_t __refs = 0)
1706 : facet(__refs), _M_data(NULL)
1707 { _M_initialize_numpunct(__cloc); }
1710 * @brief Return decimal point character.
1712 * This function returns a char_type to use as a decimal point. It
1713 * does so by returning returning
1714 * numpunct<char_type>::do_decimal_point().
1716 * @return @a char_type representing a decimal point.
1719 decimal_point() const
1720 { return this->do_decimal_point(); }
1723 * @brief Return thousands separator character.
1725 * This function returns a char_type to use as a thousands
1726 * separator. It does so by returning returning
1727 * numpunct<char_type>::do_thousands_sep().
1729 * @return char_type representing a thousands separator.
1732 thousands_sep() const
1733 { return this->do_thousands_sep(); }
1736 * @brief Return grouping specification.
1738 * This function returns a string representing groupings for the
1739 * integer part of a number. Groupings indicate where thousands
1740 * separators should be inserted in the integer part of a number.
1742 * Each char in the return string is interpret as an integer
1743 * rather than a character. These numbers represent the number
1744 * of digits in a group. The first char in the string
1745 * represents the number of digits in the least significant
1746 * group. If a char is negative, it indicates an unlimited
1747 * number of digits for the group. If more chars from the
1748 * string are required to group a number, the last char is used
1751 * For example, if the grouping() returns "\003\002" and is
1752 * applied to the number 123456789, this corresponds to
1753 * 12,34,56,789. Note that if the string was "32", this would
1754 * put more than 50 digits into the least significant group if
1755 * the character set is ASCII.
1757 * The string is returned by calling
1758 * numpunct<char_type>::do_grouping().
1760 * @return string representing grouping specification.
1764 { return this->do_grouping(); }
1767 * @brief Return string representation of bool true.
1769 * This function returns a string_type containing the text
1770 * representation for true bool variables. It does so by calling
1771 * numpunct<char_type>::do_truename().
1773 * @return string_type representing printed form of true.
1777 { return this->do_truename(); }
1780 * @brief Return string representation of bool false.
1782 * This function returns a string_type containing the text
1783 * representation for false bool variables. It does so by calling
1784 * numpunct<char_type>::do_falsename().
1786 * @return string_type representing printed form of false.
1790 { return this->do_falsename(); }
1798 * @brief Return decimal point character.
1800 * Returns a char_type to use as a decimal point. This function is a
1801 * hook for derived classes to change the value returned.
1803 * @return @a char_type representing a decimal point.
1806 do_decimal_point() const
1807 { return _M_data->_M_decimal_point; }
1810 * @brief Return thousands separator character.
1812 * Returns a char_type to use as a thousands separator. This function
1813 * is a hook for derived classes to change the value returned.
1815 * @return @a char_type representing a thousands separator.
1818 do_thousands_sep() const
1819 { return _M_data->_M_thousands_sep; }
1822 * @brief Return grouping specification.
1824 * Returns a string representing groupings for the integer part of a
1825 * number. This function is a hook for derived classes to change the
1826 * value returned. @see grouping() for details.
1828 * @return String representing grouping specification.
1832 { return _M_data->_M_grouping; }
1835 * @brief Return string representation of bool true.
1837 * Returns a string_type containing the text representation for true
1838 * bool variables. This function is a hook for derived classes to
1839 * change the value returned.
1841 * @return string_type representing printed form of true.
1845 { return _M_data->_M_truename; }
1848 * @brief Return string representation of bool false.
1850 * Returns a string_type containing the text representation for false
1851 * bool variables. This function is a hook for derived classes to
1852 * change the value returned.
1854 * @return string_type representing printed form of false.
1857 do_falsename() const
1858 { return _M_data->_M_falsename; }
1860 // For use at construction time only.
1862 _M_initialize_numpunct(__c_locale __cloc = NULL);
1865 template<typename _CharT>
1866 locale::id numpunct<_CharT>::id;
1869 numpunct<char>::~numpunct();
1873 numpunct<char>::_M_initialize_numpunct(__c_locale __cloc);
1875 #ifdef _GLIBCXX_USE_WCHAR_T
1877 numpunct<wchar_t>::~numpunct();
1881 numpunct<wchar_t>::_M_initialize_numpunct(__c_locale __cloc);
1884 template<typename _CharT>
1885 class numpunct_byname : public numpunct<_CharT>
1888 typedef _CharT char_type;
1889 typedef basic_string<_CharT> string_type;
1892 numpunct_byname(const char* __s, size_t __refs = 0)
1893 : numpunct<_CharT>(__refs)
1895 if (std::strcmp(__s, "C") != 0 && std::strcmp(__s, "POSIX") != 0)
1898 this->_S_create_c_locale(__tmp, __s);
1899 this->_M_initialize_numpunct(__tmp);
1900 this->_S_destroy_c_locale(__tmp);
1906 ~numpunct_byname() { }
1910 * @brief Facet for parsing number strings.
1912 * This facet encapsulates the code to parse and return a number
1913 * from a string. It is used by the istream numeric extraction
1916 * The num_get template uses protected virtual functions to provide the
1917 * actual results. The public accessors forward the call to the virtual
1918 * functions. These virtual functions are hooks for developers to
1919 * implement the behavior they require from the num_get facet.
1921 template<typename _CharT, typename _InIter>
1922 class num_get : public locale::facet
1928 typedef _CharT char_type;
1929 typedef _InIter iter_type;
1932 /// Numpunct facet id.
1933 static locale::id id;
1936 * @brief Constructor performs initialization.
1938 * This is the constructor provided by the standard.
1940 * @param refs Passed to the base facet class.
1943 num_get(size_t __refs = 0) : facet(__refs) { }
1946 * @brief Numeric parsing.
1948 * Parses the input stream into the bool @a v. It does so by calling
1949 * num_put::do_put().
1951 * If ios_base::boolalpha is set, attempts to read
1952 * ctype<CharT>::truename() or ctype<CharT>::falsename(). Sets
1953 * @a v to true or false if successful. Sets err to
1954 * ios_base::failbit if reading the string fails. Sets err to
1955 * ios_base::eofbit if the stream is emptied.
1957 * If ios_base::boolalpha is not set, proceeds as with reading a long,
1958 * except if the value is 1, sets @a v to true, if the value is 0, sets
1959 * @a v to false, and otherwise set err to ios_base::failbit.
1961 * @param in Start of input stream.
1962 * @param end End of input stream.
1963 * @param io Source of locale and flags.
1964 * @param err Error flags to set.
1965 * @param v Value to format and insert.
1966 * @return Iterator after reading.
1969 get(iter_type __in, iter_type __end, ios_base& __io,
1970 ios_base::iostate& __err, bool& __v) const
1971 { return this->do_get(__in, __end, __io, __err, __v); }
1975 * @brief Numeric parsing.
1977 * Parses the input stream into the integral variable @a v. It does so
1978 * by calling num_put::do_put().
1980 * Parsing is affected by the flag settings in @a io.
1982 * The basic parse is affected by the value of io.flags() &
1983 * ios_base::basefield. If equal to ios_base::oct, parses like the
1984 * scanf %o specifier. Else if equal to ios_base::hex, parses like %X
1985 * specifier. Else if basefield equal to 0, parses like the %i
1986 * specifier. Otherwise, parses like %d for signed and %u for unsigned
1987 * types. The matching type length modifier is also used.
1989 * Digit grouping is intrepreted according to numpunct::grouping() and
1990 * numpunct::thousands_sep(). If the pattern of digit groups isn't
1991 * consistent, sets err to ios_base::failbit.
1993 * If parsing the string yields a valid value for @a v, @a v is set.
1994 * Otherwise, sets err to ios_base::failbit and leaves @a v unaltered.
1995 * Sets err to ios_base::eofbit if the stream is emptied.
1997 * @param in Start of input stream.
1998 * @param end End of input stream.
1999 * @param io Source of locale and flags.
2000 * @param err Error flags to set.
2001 * @param v Value to format and insert.
2002 * @return Iterator after reading.
2005 get(iter_type __in, iter_type __end, ios_base& __io,
2006 ios_base::iostate& __err, long& __v) const
2007 { return this->do_get(__in, __end, __io, __err, __v); }
2010 get(iter_type __in, iter_type __end, ios_base& __io,
2011 ios_base::iostate& __err, unsigned short& __v) const
2012 { return this->do_get(__in, __end, __io, __err, __v); }
2015 get(iter_type __in, iter_type __end, ios_base& __io,
2016 ios_base::iostate& __err, unsigned int& __v) const
2017 { return this->do_get(__in, __end, __io, __err, __v); }
2020 get(iter_type __in, iter_type __end, ios_base& __io,
2021 ios_base::iostate& __err, unsigned long& __v) const
2022 { return this->do_get(__in, __end, __io, __err, __v); }
2024 #ifdef _GLIBCXX_USE_LONG_LONG
2026 get(iter_type __in, iter_type __end, ios_base& __io,
2027 ios_base::iostate& __err, long long& __v) const
2028 { return this->do_get(__in, __end, __io, __err, __v); }
2031 get(iter_type __in, iter_type __end, ios_base& __io,
2032 ios_base::iostate& __err, unsigned long long& __v) const
2033 { return this->do_get(__in, __end, __io, __err, __v); }
2039 * @brief Numeric parsing.
2041 * Parses the input stream into the integral variable @a v. It does so
2042 * by calling num_put::do_put().
2044 * The input characters are parsed like the scanf %g specifier. The
2045 * matching type length modifier is also used.
2047 * The decimal point character used is numpunct::decimal_point().
2048 * Digit grouping is intrepreted according to numpunct::grouping() and
2049 * numpunct::thousands_sep(). If the pattern of digit groups isn't
2050 * consistent, sets err to ios_base::failbit.
2052 * If parsing the string yields a valid value for @a v, @a v is set.
2053 * Otherwise, sets err to ios_base::failbit and leaves @a v unaltered.
2054 * Sets err to ios_base::eofbit if the stream is emptied.
2056 * @param in Start of input stream.
2057 * @param end End of input stream.
2058 * @param io Source of locale and flags.
2059 * @param err Error flags to set.
2060 * @param v Value to format and insert.
2061 * @return Iterator after reading.
2064 get(iter_type __in, iter_type __end, ios_base& __io,
2065 ios_base::iostate& __err, float& __v) const
2066 { return this->do_get(__in, __end, __io, __err, __v); }
2069 get(iter_type __in, iter_type __end, ios_base& __io,
2070 ios_base::iostate& __err, double& __v) const
2071 { return this->do_get(__in, __end, __io, __err, __v); }
2074 get(iter_type __in, iter_type __end, ios_base& __io,
2075 ios_base::iostate& __err, long double& __v) const
2076 { return this->do_get(__in, __end, __io, __err, __v); }
2080 * @brief Numeric parsing.
2082 * Parses the input stream into the pointer variable @a v. It does so
2083 * by calling num_put::do_put().
2085 * The input characters are parsed like the scanf %p specifier.
2087 * Digit grouping is intrepreted according to numpunct::grouping() and
2088 * numpunct::thousands_sep(). If the pattern of digit groups isn't
2089 * consistent, sets err to ios_base::failbit.
2091 * Note that the digit grouping effect for pointers is a bit ambiguous
2092 * in the standard and shouldn't be relied on. See DR 344.
2094 * If parsing the string yields a valid value for @a v, @a v is set.
2095 * Otherwise, sets err to ios_base::failbit and leaves @a v unaltered.
2096 * Sets err to ios_base::eofbit if the stream is emptied.
2098 * @param in Start of input stream.
2099 * @param end End of input stream.
2100 * @param io Source of locale and flags.
2101 * @param err Error flags to set.
2102 * @param v Value to format and insert.
2103 * @return Iterator after reading.
2106 get(iter_type __in, iter_type __end, ios_base& __io,
2107 ios_base::iostate& __err, void*& __v) const
2108 { return this->do_get(__in, __end, __io, __err, __v); }
2112 virtual ~num_get() { }
2115 _M_extract_float(iter_type, iter_type, ios_base&, ios_base::iostate&,
2116 string& __xtrc) const;
2118 template<typename _ValueT>
2120 _M_extract_int(iter_type, iter_type, ios_base&, ios_base::iostate&,
2121 _ValueT& __v) const;
2125 * @brief Numeric parsing.
2127 * Parses the input stream into the variable @a v. This function is a
2128 * hook for derived classes to change the value returned. @see get()
2131 * @param in Start of input stream.
2132 * @param end End of input stream.
2133 * @param io Source of locale and flags.
2134 * @param err Error flags to set.
2135 * @param v Value to format and insert.
2136 * @return Iterator after reading.
2139 do_get(iter_type, iter_type, ios_base&, ios_base::iostate&, bool&) const;
2143 do_get(iter_type, iter_type, ios_base&, ios_base::iostate&, long&) const;
2146 do_get(iter_type, iter_type, ios_base&, ios_base::iostate& __err,
2147 unsigned short&) const;
2150 do_get(iter_type, iter_type, ios_base&, ios_base::iostate& __err,
2151 unsigned int&) const;
2154 do_get(iter_type, iter_type, ios_base&, ios_base::iostate& __err,
2155 unsigned long&) const;
2157 #ifdef _GLIBCXX_USE_LONG_LONG
2159 do_get(iter_type, iter_type, ios_base&, ios_base::iostate& __err,
2163 do_get(iter_type, iter_type, ios_base&, ios_base::iostate& __err,
2164 unsigned long long&) const;
2168 do_get(iter_type, iter_type, ios_base&, ios_base::iostate& __err,
2172 do_get(iter_type, iter_type, ios_base&, ios_base::iostate& __err,
2176 do_get(iter_type, iter_type, ios_base&, ios_base::iostate& __err,
2177 long double&) const;
2180 do_get(iter_type, iter_type, ios_base&, ios_base::iostate& __err,
2185 template<typename _CharT, typename _InIter>
2186 locale::id num_get<_CharT, _InIter>::id;
2190 * @brief Facet for converting numbers to strings.
2192 * This facet encapsulates the code to convert a number to a string. It is
2193 * used by the ostream numeric insertion operators.
2195 * The num_put template uses protected virtual functions to provide the
2196 * actual results. The public accessors forward the call to the virtual
2197 * functions. These virtual functions are hooks for developers to
2198 * implement the behavior they require from the num_put facet.
2200 template<typename _CharT, typename _OutIter>
2201 class num_put : public locale::facet
2207 typedef _CharT char_type;
2208 typedef _OutIter iter_type;
2211 /// Numpunct facet id.
2212 static locale::id id;
2215 * @brief Constructor performs initialization.
2217 * This is the constructor provided by the standard.
2219 * @param refs Passed to the base facet class.
2222 num_put(size_t __refs = 0) : facet(__refs) { }
2225 * @brief Numeric formatting.
2227 * Formats the boolean @a v and inserts it into a stream. It does so
2228 * by calling num_put::do_put().
2230 * If ios_base::boolalpha is set, writes ctype<CharT>::truename() or
2231 * ctype<CharT>::falsename(). Otherwise formats @a v as an int.
2233 * @param s Stream to write to.
2234 * @param io Source of locale and flags.
2235 * @param fill Char_type to use for filling.
2236 * @param v Value to format and insert.
2237 * @return Iterator after writing.
2240 put(iter_type __s, ios_base& __f, char_type __fill, bool __v) const
2241 { return this->do_put(__s, __f, __fill, __v); }
2245 * @brief Numeric formatting.
2247 * Formats the integral value @a v and inserts it into a
2248 * stream. It does so by calling num_put::do_put().
2250 * Formatting is affected by the flag settings in @a io.
2252 * The basic format is affected by the value of io.flags() &
2253 * ios_base::basefield. If equal to ios_base::oct, formats like the
2254 * printf %o specifier. Else if equal to ios_base::hex, formats like
2255 * %x or %X with ios_base::uppercase unset or set respectively.
2256 * Otherwise, formats like %d, %ld, %lld for signed and %u, %lu, %llu
2257 * for unsigned values. Note that if both oct and hex are set, neither
2260 * If ios_base::showpos is set, '+' is output before positive values.
2261 * If ios_base::showbase is set, '0' precedes octal values (except 0)
2262 * and '0[xX]' precedes hex values.
2264 * Thousands separators are inserted according to numpunct::grouping()
2265 * and numpunct::thousands_sep(). The decimal point character used is
2266 * numpunct::decimal_point().
2268 * If io.width() is non-zero, enough @a fill characters are inserted to
2269 * make the result at least that wide. If
2270 * (io.flags() & ios_base::adjustfield) == ios_base::left, result is
2271 * padded at the end. If ios_base::internal, then padding occurs
2272 * immediately after either a '+' or '-' or after '0x' or '0X'.
2273 * Otherwise, padding occurs at the beginning.
2275 * @param s Stream to write to.
2276 * @param io Source of locale and flags.
2277 * @param fill Char_type to use for filling.
2278 * @param v Value to format and insert.
2279 * @return Iterator after writing.
2282 put(iter_type __s, ios_base& __f, char_type __fill, long __v) const
2283 { return this->do_put(__s, __f, __fill, __v); }
2286 put(iter_type __s, ios_base& __f, char_type __fill,
2287 unsigned long __v) const
2288 { return this->do_put(__s, __f, __fill, __v); }
2290 #ifdef _GLIBCXX_USE_LONG_LONG
2292 put(iter_type __s, ios_base& __f, char_type __fill, long long __v) const
2293 { return this->do_put(__s, __f, __fill, __v); }
2296 put(iter_type __s, ios_base& __f, char_type __fill,
2297 unsigned long long __v) const
2298 { return this->do_put(__s, __f, __fill, __v); }
2304 * @brief Numeric formatting.
2306 * Formats the floating point value @a v and inserts it into a stream.
2307 * It does so by calling num_put::do_put().
2309 * Formatting is affected by the flag settings in @a io.
2311 * The basic format is affected by the value of io.flags() &
2312 * ios_base::floatfield. If equal to ios_base::fixed, formats like the
2313 * printf %f specifier. Else if equal to ios_base::scientific, formats
2314 * like %e or %E with ios_base::uppercase unset or set respectively.
2315 * Otherwise, formats like %g or %G depending on uppercase. Note that
2316 * if both fixed and scientific are set, the effect will also be like
2319 * The output precision is given by io.precision(). This precision is
2320 * capped at numeric_limits::digits10 + 2 (different for double and
2321 * long double). The default precision is 6.
2323 * If ios_base::showpos is set, '+' is output before positive values.
2324 * If ios_base::showpoint is set, a decimal point will always be
2327 * Thousands separators are inserted according to numpunct::grouping()
2328 * and numpunct::thousands_sep(). The decimal point character used is
2329 * numpunct::decimal_point().
2331 * If io.width() is non-zero, enough @a fill characters are inserted to
2332 * make the result at least that wide. If
2333 * (io.flags() & ios_base::adjustfield) == ios_base::left, result is
2334 * padded at the end. If ios_base::internal, then padding occurs
2335 * immediately after either a '+' or '-' or after '0x' or '0X'.
2336 * Otherwise, padding occurs at the beginning.
2338 * @param s Stream to write to.
2339 * @param io Source of locale and flags.
2340 * @param fill Char_type to use for filling.
2341 * @param v Value to format and insert.
2342 * @return Iterator after writing.
2345 put(iter_type __s, ios_base& __f, char_type __fill, double __v) const
2346 { return this->do_put(__s, __f, __fill, __v); }
2349 put(iter_type __s, ios_base& __f, char_type __fill,
2350 long double __v) const
2351 { return this->do_put(__s, __f, __fill, __v); }
2355 * @brief Numeric formatting.
2357 * Formats the pointer value @a v and inserts it into a stream. It
2358 * does so by calling num_put::do_put().
2360 * This function formats @a v as an unsigned long with ios_base::hex
2361 * and ios_base::showbase set.
2363 * @param s Stream to write to.
2364 * @param io Source of locale and flags.
2365 * @param fill Char_type to use for filling.
2366 * @param v Value to format and insert.
2367 * @return Iterator after writing.
2370 put(iter_type __s, ios_base& __f, char_type __fill,
2371 const void* __v) const
2372 { return this->do_put(__s, __f, __fill, __v); }
2375 template<typename _ValueT>
2377 _M_insert_float(iter_type, ios_base& __io, char_type __fill,
2378 char __mod, _ValueT __v) const;
2381 _M_group_float(const char* __grouping, size_t __grouping_size,
2382 char_type __sep, const char_type* __p, char_type* __new,
2383 char_type* __cs, int& __len) const;
2385 template<typename _ValueT>
2387 _M_insert_int(iter_type, ios_base& __io, char_type __fill,
2391 _M_group_int(const char* __grouping, size_t __grouping_size,
2392 char_type __sep, ios_base& __io, char_type* __new,
2393 char_type* __cs, int& __len) const;
2396 _M_pad(char_type __fill, streamsize __w, ios_base& __io,
2397 char_type* __new, const char_type* __cs, int& __len) const;
2405 * @brief Numeric formatting.
2407 * These functions do the work of formatting numeric values and
2408 * inserting them into a stream. This function is a hook for derived
2409 * classes to change the value returned.
2411 * @param s Stream to write to.
2412 * @param io Source of locale and flags.
2413 * @param fill Char_type to use for filling.
2414 * @param v Value to format and insert.
2415 * @return Iterator after writing.
2418 do_put(iter_type, ios_base&, char_type __fill, bool __v) const;
2421 do_put(iter_type, ios_base&, char_type __fill, long __v) const;
2424 do_put(iter_type, ios_base&, char_type __fill, unsigned long) const;
2426 #ifdef _GLIBCXX_USE_LONG_LONG
2428 do_put(iter_type, ios_base&, char_type __fill, long long __v) const;
2431 do_put(iter_type, ios_base&, char_type __fill, unsigned long long) const;
2435 do_put(iter_type, ios_base&, char_type __fill, double __v) const;
2438 do_put(iter_type, ios_base&, char_type __fill, long double __v) const;
2441 do_put(iter_type, ios_base&, char_type __fill, const void* __v) const;
2445 template <typename _CharT, typename _OutIter>
2446 locale::id num_put<_CharT, _OutIter>::id;
2450 * @brief Facet for localized string comparison.
2452 * This facet encapsulates the code to compare strings in a localized
2455 * The collate template uses protected virtual functions to provide
2456 * the actual results. The public accessors forward the call to
2457 * the virtual functions. These virtual functions are hooks for
2458 * developers to implement the behavior they require from the
2461 template<typename _CharT>
2462 class collate : public locale::facet
2468 typedef _CharT char_type;
2469 typedef basic_string<_CharT> string_type;
2473 // Underlying "C" library locale information saved from
2474 // initialization, needed by collate_byname as well.
2475 __c_locale _M_c_locale_collate;
2478 /// Numpunct facet id.
2479 static locale::id id;
2482 * @brief Constructor performs initialization.
2484 * This is the constructor provided by the standard.
2486 * @param refs Passed to the base facet class.
2489 collate(size_t __refs = 0)
2491 { _M_c_locale_collate = _S_get_c_locale(); }
2494 * @brief Internal constructor. Not for general use.
2496 * This is a constructor for use by the library itself to set up new
2499 * @param cloc The "C" locale.
2500 * @param refs Passed to the base facet class.
2503 collate(__c_locale __cloc, size_t __refs = 0)
2505 { _M_c_locale_collate = _S_clone_c_locale(__cloc); }
2508 * @brief Compare two strings.
2510 * This function compares two strings and returns the result by calling
2511 * collate::do_compare().
2513 * @param lo1 Start of string 1.
2514 * @param hi1 End of string 1.
2515 * @param lo2 Start of string 2.
2516 * @param hi2 End of string 2.
2517 * @return 1 if string1 > string2, -1 if string1 < string2, else 0.
2520 compare(const _CharT* __lo1, const _CharT* __hi1,
2521 const _CharT* __lo2, const _CharT* __hi2) const
2522 { return this->do_compare(__lo1, __hi1, __lo2, __hi2); }
2525 * @brief Transform string to comparable form.
2527 * This function is a wrapper for strxfrm functionality. It takes the
2528 * input string and returns a modified string that can be directly
2529 * compared to other transformed strings. In the "C" locale, this
2530 * function just returns a copy of the input string. In some other
2531 * locales, it may replace two chars with one, change a char for
2532 * another, etc. It does so by returning collate::do_transform().
2534 * @param lo Start of string.
2535 * @param hi End of string.
2536 * @return Transformed string_type.
2539 transform(const _CharT* __lo, const _CharT* __hi) const
2540 { return this->do_transform(__lo, __hi); }
2543 * @brief Return hash of a string.
2545 * This function computes and returns a hash on the input string. It
2546 * does so by returning collate::do_hash().
2548 * @param lo Start of string.
2549 * @param hi End of string.
2550 * @return Hash value.
2553 hash(const _CharT* __lo, const _CharT* __hi) const
2554 { return this->do_hash(__lo, __hi); }
2556 // Used to abstract out _CharT bits in virtual member functions, below.
2558 _M_compare(const _CharT*, const _CharT*) const;
2561 _M_transform(_CharT*, const _CharT*, size_t) const;
2567 { _S_destroy_c_locale(_M_c_locale_collate); }
2570 * @brief Compare two strings.
2572 * This function is a hook for derived classes to change the value
2573 * returned. @see compare().
2575 * @param lo1 Start of string 1.
2576 * @param hi1 End of string 1.
2577 * @param lo2 Start of string 2.
2578 * @param hi2 End of string 2.
2579 * @return 1 if string1 > string2, -1 if string1 < string2, else 0.
2582 do_compare(const _CharT* __lo1, const _CharT* __hi1,
2583 const _CharT* __lo2, const _CharT* __hi2) const;
2586 * @brief Transform string to comparable form.
2588 * This function is a hook for derived classes to change the value
2591 * @param lo1 Start of string 1.
2592 * @param hi1 End of string 1.
2593 * @param lo2 Start of string 2.
2594 * @param hi2 End of string 2.
2595 * @return 1 if string1 > string2, -1 if string1 < string2, else 0.
2598 do_transform(const _CharT* __lo, const _CharT* __hi) const;
2601 * @brief Return hash of a string.
2603 * This function computes and returns a hash on the input string. This
2604 * function is a hook for derived classes to change the value returned.
2606 * @param lo Start of string.
2607 * @param hi End of string.
2608 * @return Hash value.
2611 do_hash(const _CharT* __lo, const _CharT* __hi) const;
2614 template<typename _CharT>
2615 locale::id collate<_CharT>::id;
2620 collate<char>::_M_compare(const char*, const char*) const;
2624 collate<char>::_M_transform(char*, const char*, size_t) const;
2626 #ifdef _GLIBCXX_USE_WCHAR_T
2629 collate<wchar_t>::_M_compare(const wchar_t*, const wchar_t*) const;
2633 collate<wchar_t>::_M_transform(wchar_t*, const wchar_t*, size_t) const;
2636 template<typename _CharT>
2637 class collate_byname : public collate<_CharT>
2642 typedef _CharT char_type;
2643 typedef basic_string<_CharT> string_type;
2647 collate_byname(const char* __s, size_t __refs = 0)
2648 : collate<_CharT>(__refs)
2650 if (std::strcmp(__s, "C") != 0 && std::strcmp(__s, "POSIX") != 0)
2652 this->_S_destroy_c_locale(this->_M_c_locale_collate);
2653 this->_S_create_c_locale(this->_M_c_locale_collate, __s);
2659 ~collate_byname() { }
2664 * @brief Time format ordering data.
2666 * This class provides an enum representing different orderings of day,
2672 enum dateorder { no_order, dmy, mdy, ymd, ydm };
2675 template<typename _CharT>
2676 struct __timepunct_cache : public locale::facet
2678 // List of all known timezones, with GMT first.
2679 static const _CharT* _S_timezones[14];
2681 const _CharT* _M_date_format;
2682 const _CharT* _M_date_era_format;
2683 const _CharT* _M_time_format;
2684 const _CharT* _M_time_era_format;
2685 const _CharT* _M_date_time_format;
2686 const _CharT* _M_date_time_era_format;
2687 const _CharT* _M_am;
2688 const _CharT* _M_pm;
2689 const _CharT* _M_am_pm_format;
2691 // Day names, starting with "C"'s Sunday.
2692 const _CharT* _M_day1;
2693 const _CharT* _M_day2;
2694 const _CharT* _M_day3;
2695 const _CharT* _M_day4;
2696 const _CharT* _M_day5;
2697 const _CharT* _M_day6;
2698 const _CharT* _M_day7;
2700 // Abbreviated day names, starting with "C"'s Sun.
2701 const _CharT* _M_aday1;
2702 const _CharT* _M_aday2;
2703 const _CharT* _M_aday3;
2704 const _CharT* _M_aday4;
2705 const _CharT* _M_aday5;
2706 const _CharT* _M_aday6;
2707 const _CharT* _M_aday7;
2709 // Month names, starting with "C"'s January.
2710 const _CharT* _M_month01;
2711 const _CharT* _M_month02;
2712 const _CharT* _M_month03;
2713 const _CharT* _M_month04;
2714 const _CharT* _M_month05;
2715 const _CharT* _M_month06;
2716 const _CharT* _M_month07;
2717 const _CharT* _M_month08;
2718 const _CharT* _M_month09;
2719 const _CharT* _M_month10;
2720 const _CharT* _M_month11;
2721 const _CharT* _M_month12;
2723 // Abbreviated month names, starting with "C"'s Jan.
2724 const _CharT* _M_amonth01;
2725 const _CharT* _M_amonth02;
2726 const _CharT* _M_amonth03;
2727 const _CharT* _M_amonth04;
2728 const _CharT* _M_amonth05;
2729 const _CharT* _M_amonth06;
2730 const _CharT* _M_amonth07;
2731 const _CharT* _M_amonth08;
2732 const _CharT* _M_amonth09;
2733 const _CharT* _M_amonth10;
2734 const _CharT* _M_amonth11;
2735 const _CharT* _M_amonth12;
2739 __timepunct_cache(size_t __refs = 0) : facet(__refs),
2740 _M_date_format(NULL), _M_date_era_format(NULL), _M_time_format(NULL),
2741 _M_time_era_format(NULL), _M_date_time_format(NULL),
2742 _M_date_time_era_format(NULL), _M_am(NULL), _M_pm(NULL),
2743 _M_am_pm_format(NULL), _M_day1(NULL), _M_day2(NULL), _M_day3(NULL),
2744 _M_day4(NULL), _M_day5(NULL), _M_day6(NULL), _M_day7(NULL),
2745 _M_aday1(NULL), _M_aday2(NULL), _M_aday3(NULL), _M_aday4(NULL),
2746 _M_aday5(NULL), _M_aday6(NULL), _M_aday7(NULL), _M_month01(NULL),
2747 _M_month02(NULL), _M_month03(NULL), _M_month04(NULL), _M_month05(NULL),
2748 _M_month06(NULL), _M_month07(NULL), _M_month08(NULL), _M_month09(NULL),
2749 _M_month10(NULL), _M_month11(NULL), _M_month12(NULL), _M_amonth01(NULL),
2750 _M_amonth02(NULL), _M_amonth03(NULL), _M_amonth04(NULL),
2751 _M_amonth05(NULL), _M_amonth06(NULL), _M_amonth07(NULL),
2752 _M_amonth08(NULL), _M_amonth09(NULL), _M_amonth10(NULL),
2753 _M_amonth11(NULL), _M_amonth12(NULL), _M_allocated(false)
2756 ~__timepunct_cache();
2759 _M_cache(const locale& __loc);
2762 template<typename _CharT>
2763 __timepunct_cache<_CharT>::~__timepunct_cache()
2774 __timepunct_cache<char>::_S_timezones[14];
2776 #ifdef _GLIBCXX_USE_WCHAR_T
2779 __timepunct_cache<wchar_t>::_S_timezones[14];
2783 template<typename _CharT>
2784 const _CharT* __timepunct_cache<_CharT>::_S_timezones[14];
2786 template<typename _CharT>
2787 class __timepunct : public locale::facet
2791 typedef _CharT __char_type;
2792 typedef basic_string<_CharT> __string_type;
2793 typedef __timepunct_cache<_CharT> __cache_type;
2796 __cache_type* _M_data;
2797 __c_locale _M_c_locale_timepunct;
2798 const char* _M_name_timepunct;
2801 /// Numpunct facet id.
2802 static locale::id id;
2805 __timepunct(size_t __refs = 0);
2808 __timepunct(__cache_type* __cache, size_t __refs = 0);
2811 * @brief Internal constructor. Not for general use.
2813 * This is a constructor for use by the library itself to set up new
2816 * @param cloc The "C" locale.
2817 * @param s The name of a locale.
2818 * @param refs Passed to the base facet class.
2821 __timepunct(__c_locale __cloc, const char* __s, size_t __refs = 0);
2824 _M_put(_CharT* __s, size_t __maxlen, const _CharT* __format,
2825 const tm* __tm) const;
2828 _M_date_formats(const _CharT** __date) const
2830 // Always have default first.
2831 __date[0] = _M_data->_M_date_format;
2832 __date[1] = _M_data->_M_date_era_format;
2836 _M_time_formats(const _CharT** __time) const
2838 // Always have default first.
2839 __time[0] = _M_data->_M_time_format;
2840 __time[1] = _M_data->_M_time_era_format;
2844 _M_date_time_formats(const _CharT** __dt) const
2846 // Always have default first.
2847 __dt[0] = _M_data->_M_date_time_format;
2848 __dt[1] = _M_data->_M_date_time_era_format;
2852 _M_am_pm_format(const _CharT* __ampm) const
2853 { __ampm = _M_data->_M_am_pm_format; }
2856 _M_am_pm(const _CharT** __ampm) const
2858 __ampm[0] = _M_data->_M_am;
2859 __ampm[1] = _M_data->_M_pm;
2863 _M_days(const _CharT** __days) const
2865 __days[0] = _M_data->_M_day1;
2866 __days[1] = _M_data->_M_day2;
2867 __days[2] = _M_data->_M_day3;
2868 __days[3] = _M_data->_M_day4;
2869 __days[4] = _M_data->_M_day5;
2870 __days[5] = _M_data->_M_day6;
2871 __days[6] = _M_data->_M_day7;
2875 _M_days_abbreviated(const _CharT** __days) const
2877 __days[0] = _M_data->_M_aday1;
2878 __days[1] = _M_data->_M_aday2;
2879 __days[2] = _M_data->_M_aday3;
2880 __days[3] = _M_data->_M_aday4;
2881 __days[4] = _M_data->_M_aday5;
2882 __days[5] = _M_data->_M_aday6;
2883 __days[6] = _M_data->_M_aday7;
2887 _M_months(const _CharT** __months) const
2889 __months[0] = _M_data->_M_month01;
2890 __months[1] = _M_data->_M_month02;
2891 __months[2] = _M_data->_M_month03;
2892 __months[3] = _M_data->_M_month04;
2893 __months[4] = _M_data->_M_month05;
2894 __months[5] = _M_data->_M_month06;
2895 __months[6] = _M_data->_M_month07;
2896 __months[7] = _M_data->_M_month08;
2897 __months[8] = _M_data->_M_month09;
2898 __months[9] = _M_data->_M_month10;
2899 __months[10] = _M_data->_M_month11;
2900 __months[11] = _M_data->_M_month12;
2904 _M_months_abbreviated(const _CharT** __months) const
2906 __months[0] = _M_data->_M_amonth01;
2907 __months[1] = _M_data->_M_amonth02;
2908 __months[2] = _M_data->_M_amonth03;
2909 __months[3] = _M_data->_M_amonth04;
2910 __months[4] = _M_data->_M_amonth05;
2911 __months[5] = _M_data->_M_amonth06;
2912 __months[6] = _M_data->_M_amonth07;
2913 __months[7] = _M_data->_M_amonth08;
2914 __months[8] = _M_data->_M_amonth09;
2915 __months[9] = _M_data->_M_amonth10;
2916 __months[10] = _M_data->_M_amonth11;
2917 __months[11] = _M_data->_M_amonth12;
2924 // For use at construction time only.
2926 _M_initialize_timepunct(__c_locale __cloc = NULL);
2929 template<typename _CharT>
2930 locale::id __timepunct<_CharT>::id;
2935 __timepunct<char>::_M_initialize_timepunct(__c_locale __cloc);
2939 __timepunct<char>::_M_put(char*, size_t, const char*, const tm*) const;
2941 #ifdef _GLIBCXX_USE_WCHAR_T
2944 __timepunct<wchar_t>::_M_initialize_timepunct(__c_locale __cloc);
2948 __timepunct<wchar_t>::_M_put(wchar_t*, size_t, const wchar_t*,
2952 // Include host and configuration specific timepunct functions.
2953 #include <bits/time_members.h>
2956 * @brief Facet for parsing dates and times.
2958 * This facet encapsulates the code to parse and return a date or
2959 * time from a string. It is used by the istream numeric
2960 * extraction operators.
2962 * The time_get template uses protected virtual functions to provide the
2963 * actual results. The public accessors forward the call to the virtual
2964 * functions. These virtual functions are hooks for developers to
2965 * implement the behavior they require from the time_get facet.
2967 template<typename _CharT, typename _InIter>
2968 class time_get : public locale::facet, public time_base
2974 typedef _CharT char_type;
2975 typedef _InIter iter_type;
2977 typedef basic_string<_CharT> __string_type;
2979 /// Numpunct facet id.
2980 static locale::id id;
2983 * @brief Constructor performs initialization.
2985 * This is the constructor provided by the standard.
2987 * @param refs Passed to the base facet class.
2990 time_get(size_t __refs = 0)
2991 : facet (__refs) { }
2994 * @brief Return preferred order of month, day, and year.
2996 * This function returns an enum from timebase::dateorder giving the
2997 * preferred ordering if the format "x" given to time_put::put() only
2998 * uses month, day, and year. If the format "x" for the associated
2999 * locale uses other fields, this function returns
3000 * timebase::dateorder::noorder.
3002 * NOTE: The library always returns noorder at the moment.
3004 * @return A member of timebase::dateorder.
3008 { return this->do_date_order(); }
3011 * @brief Parse input time string.
3013 * This function parses a time according to the format "x" and puts the
3014 * results into a user-supplied struct tm. The result is returned by
3015 * calling time_get::do_get_time().
3017 * If there is a valid time string according to format "x", @a tm will
3018 * be filled in accordingly and the returned iterator will point to the
3019 * first character beyond the time string. If an error occurs before
3020 * the end, err |= ios_base::failbit. If parsing reads all the
3021 * characters, err |= ios_base::eofbit.
3023 * @param beg Start of string to parse.
3024 * @param end End of string to parse.
3025 * @param io Source of the locale.
3026 * @param err Error flags to set.
3027 * @param tm Pointer to struct tm to fill in.
3028 * @return Iterator to first char beyond time string.
3031 get_time(iter_type __beg, iter_type __end, ios_base& __io,
3032 ios_base::iostate& __err, tm* __tm) const
3033 { return this->do_get_time(__beg, __end, __io, __err, __tm); }
3036 * @brief Parse input date string.
3038 * This function parses a date according to the format "X" and puts the
3039 * results into a user-supplied struct tm. The result is returned by
3040 * calling time_get::do_get_date().
3042 * If there is a valid date string according to format "X", @a tm will
3043 * be filled in accordingly and the returned iterator will point to the
3044 * first character beyond the date string. If an error occurs before
3045 * the end, err |= ios_base::failbit. If parsing reads all the
3046 * characters, err |= ios_base::eofbit.
3048 * @param beg Start of string to parse.
3049 * @param end End of string to parse.
3050 * @param io Source of the locale.
3051 * @param err Error flags to set.
3052 * @param tm Pointer to struct tm to fill in.
3053 * @return Iterator to first char beyond date string.
3056 get_date(iter_type __beg, iter_type __end, ios_base& __io,
3057 ios_base::iostate& __err, tm* __tm) const
3058 { return this->do_get_date(__beg, __end, __io, __err, __tm); }
3061 * @brief Parse input weekday string.
3063 * This function parses a weekday name and puts the results into a
3064 * user-supplied struct tm. The result is returned by calling
3065 * time_get::do_get_weekday().
3067 * Parsing starts by parsing an abbreviated weekday name. If a valid
3068 * abbreviation is followed by a character that would lead to the full
3069 * weekday name, parsing continues until the full name is found or an
3070 * error occurs. Otherwise parsing finishes at the end of the
3073 * If an error occurs before the end, err |= ios_base::failbit. If
3074 * parsing reads all the characters, err |= ios_base::eofbit.
3076 * @param beg Start of string to parse.
3077 * @param end End of string to parse.
3078 * @param io Source of the locale.
3079 * @param err Error flags to set.
3080 * @param tm Pointer to struct tm to fill in.
3081 * @return Iterator to first char beyond weekday name.
3084 get_weekday(iter_type __beg, iter_type __end, ios_base& __io,
3085 ios_base::iostate& __err, tm* __tm) const
3086 { return this->do_get_weekday(__beg, __end, __io, __err, __tm); }
3089 * @brief Parse input month string.
3091 * This function parses a month name and puts the results into a
3092 * user-supplied struct tm. The result is returned by calling
3093 * time_get::do_get_monthname().
3095 * Parsing starts by parsing an abbreviated month name. If a valid
3096 * abbreviation is followed by a character that would lead to the full
3097 * month name, parsing continues until the full name is found or an
3098 * error occurs. Otherwise parsing finishes at the end of the
3101 * If an error occurs before the end, err |= ios_base::failbit. If
3102 * parsing reads all the characters, err |=
3105 * @param beg Start of string to parse.
3106 * @param end End of string to parse.
3107 * @param io Source of the locale.
3108 * @param err Error flags to set.
3109 * @param tm Pointer to struct tm to fill in.
3110 * @return Iterator to first char beyond month name.
3113 get_monthname(iter_type __beg, iter_type __end, ios_base& __io,
3114 ios_base::iostate& __err, tm* __tm) const
3115 { return this->do_get_monthname(__beg, __end, __io, __err, __tm); }
3118 * @brief Parse input year string.
3120 * This function reads up to 4 characters to parse a year string and
3121 * puts the results into a user-supplied struct tm. The result is
3122 * returned by calling time_get::do_get_year().
3124 * 4 consecutive digits are interpreted as a full year. If there are
3125 * exactly 2 consecutive digits, the library interprets this as the
3126 * number of years since 1900.
3128 * If an error occurs before the end, err |= ios_base::failbit. If
3129 * parsing reads all the characters, err |= ios_base::eofbit.
3131 * @param beg Start of string to parse.
3132 * @param end End of string to parse.
3133 * @param io Source of the locale.
3134 * @param err Error flags to set.
3135 * @param tm Pointer to struct tm to fill in.
3136 * @return Iterator to first char beyond year.
3139 get_year(iter_type __beg, iter_type __end, ios_base& __io,
3140 ios_base::iostate& __err, tm* __tm) const
3141 { return this->do_get_year(__beg, __end, __io, __err, __tm); }
3149 * @brief Return preferred order of month, day, and year.
3151 * This function returns an enum from timebase::dateorder giving the
3152 * preferred ordering if the format "x" given to time_put::put() only
3153 * uses month, day, and year. This function is a hook for derived
3154 * classes to change the value returned.
3156 * @return A member of timebase::dateorder.
3159 do_date_order() const;
3162 * @brief Parse input time string.
3164 * This function parses a time according to the format "x" and puts the
3165 * results into a user-supplied struct tm. This function is a hook for
3166 * derived classes to change the value returned. @see get_time() for
3169 * @param beg Start of string to parse.
3170 * @param end End of string to parse.
3171 * @param io Source of the locale.
3172 * @param err Error flags to set.
3173 * @param tm Pointer to struct tm to fill in.
3174 * @return Iterator to first char beyond time string.
3177 do_get_time(iter_type __beg, iter_type __end, ios_base& __io,
3178 ios_base::iostate& __err, tm* __tm) const;
3181 * @brief Parse input date string.
3183 * This function parses a date according to the format "X" and puts the
3184 * results into a user-supplied struct tm. This function is a hook for
3185 * derived classes to change the value returned. @see get_date() for
3188 * @param beg Start of string to parse.
3189 * @param end End of string to parse.
3190 * @param io Source of the locale.
3191 * @param err Error flags to set.
3192 * @param tm Pointer to struct tm to fill in.
3193 * @return Iterator to first char beyond date string.
3196 do_get_date(iter_type __beg, iter_type __end, ios_base& __io,
3197 ios_base::iostate& __err, tm* __tm) const;
3200 * @brief Parse input weekday string.
3202 * This function parses a weekday name and puts the results into a
3203 * user-supplied struct tm. This function is a hook for derived
3204 * classes to change the value returned. @see get_weekday() for
3207 * @param beg Start of string to parse.
3208 * @param end End of string to parse.
3209 * @param io Source of the locale.
3210 * @param err Error flags to set.
3211 * @param tm Pointer to struct tm to fill in.
3212 * @return Iterator to first char beyond weekday name.
3215 do_get_weekday(iter_type __beg, iter_type __end, ios_base&,
3216 ios_base::iostate& __err, tm* __tm) const;
3219 * @brief Parse input month string.
3221 * This function parses a month name and puts the results into a
3222 * user-supplied struct tm. This function is a hook for derived
3223 * classes to change the value returned. @see get_monthname() for
3226 * @param beg Start of string to parse.
3227 * @param end End of string to parse.
3228 * @param io Source of the locale.
3229 * @param err Error flags to set.
3230 * @param tm Pointer to struct tm to fill in.
3231 * @return Iterator to first char beyond month name.
3234 do_get_monthname(iter_type __beg, iter_type __end, ios_base&,
3235 ios_base::iostate& __err, tm* __tm) const;
3238 * @brief Parse input year string.
3240 * This function reads up to 4 characters to parse a year string and
3241 * puts the results into a user-supplied struct tm. This function is a
3242 * hook for derived classes to change the value returned. @see
3243 * get_year() for details.
3245 * @param beg Start of string to parse.
3246 * @param end End of string to parse.
3247 * @param io Source of the locale.
3248 * @param err Error flags to set.
3249 * @param tm Pointer to struct tm to fill in.
3250 * @return Iterator to first char beyond year.
3253 do_get_year(iter_type __beg, iter_type __end, ios_base& __io,
3254 ios_base::iostate& __err, tm* __tm) const;
3256 // Extract numeric component of length __len.
3258 _M_extract_num(iter_type __beg, iter_type __end, int& __member,
3259 int __min, int __max, size_t __len,
3260 ios_base& __io, ios_base::iostate& __err) const;
3262 // Extract day or month name, or any unique array of string
3263 // literals in a const _CharT* array.
3265 _M_extract_name(iter_type __beg, iter_type __end, int& __member,
3266 const _CharT** __names, size_t __indexlen,
3267 ios_base& __io, ios_base::iostate& __err) const;
3269 // Extract on a component-by-component basis, via __format argument.
3271 _M_extract_via_format(iter_type __beg, iter_type __end, ios_base& __io,
3272 ios_base::iostate& __err, tm* __tm,
3273 const _CharT* __format) const;
3276 template<typename _CharT, typename _InIter>
3277 locale::id time_get<_CharT, _InIter>::id;
3279 template<typename _CharT, typename _InIter>
3280 class time_get_byname : public time_get<_CharT, _InIter>
3284 typedef _CharT char_type;
3285 typedef _InIter iter_type;
3288 time_get_byname(const char*, size_t __refs = 0)
3289 : time_get<_CharT, _InIter>(__refs) { }
3293 ~time_get_byname() { }
3297 * @brief Facet for outputting dates and times.
3299 * This facet encapsulates the code to format and output dates and times
3300 * according to formats used by strftime().
3302 * The time_put template uses protected virtual functions to provide the
3303 * actual results. The public accessors forward the call to the virtual
3304 * functions. These virtual functions are hooks for developers to
3305 * implement the behavior they require from the time_put facet.
3307 template<typename _CharT, typename _OutIter>
3308 class time_put : public locale::facet
3314 typedef _CharT char_type;
3315 typedef _OutIter iter_type;
3318 /// Numpunct facet id.
3319 static locale::id id;
3322 * @brief Constructor performs initialization.
3324 * This is the constructor provided by the standard.
3326 * @param refs Passed to the base facet class.
3329 time_put(size_t __refs = 0)
3333 * @brief Format and output a time or date.
3335 * This function formats the data in struct tm according to the
3336 * provided format string. The format string is interpreted as by
3339 * @param s The stream to write to.
3340 * @param io Source of locale.
3341 * @param fill char_type to use for padding.
3342 * @param tm Struct tm with date and time info to format.
3343 * @param beg Start of format string.
3344 * @param end End of format string.
3345 * @return Iterator after writing.
3348 put(iter_type __s, ios_base& __io, char_type __fill, const tm* __tm,
3349 const _CharT* __beg, const _CharT* __end) const;
3352 * @brief Format and output a time or date.
3354 * This function formats the data in struct tm according to the
3355 * provided format char and optional modifier. The format and modifier
3356 * are interpreted as by strftime(). It does so by returning
3357 * time_put::do_put().
3359 * @param s The stream to write to.
3360 * @param io Source of locale.
3361 * @param fill char_type to use for padding.
3362 * @param tm Struct tm with date and time info to format.
3363 * @param format Format char.
3364 * @param mod Optional modifier char.
3365 * @return Iterator after writing.
3368 put(iter_type __s, ios_base& __io, char_type __fill,
3369 const tm* __tm, char __format, char __mod = 0) const
3370 { return this->do_put(__s, __io, __fill, __tm, __format, __mod); }
3379 * @brief Format and output a time or date.
3381 * This function formats the data in struct tm according to the
3382 * provided format char and optional modifier. This function is a hook
3383 * for derived classes to change the value returned. @see put() for
3386 * @param s The stream to write to.
3387 * @param io Source of locale.
3388 * @param fill char_type to use for padding.
3389 * @param tm Struct tm with date and time info to format.
3390 * @param format Format char.
3391 * @param mod Optional modifier char.
3392 * @return Iterator after writing.
3395 do_put(iter_type __s, ios_base& __io, char_type __fill, const tm* __tm,
3396 char __format, char __mod) const;
3399 template<typename _CharT, typename _OutIter>
3400 locale::id time_put<_CharT, _OutIter>::id;
3402 template<typename _CharT, typename _OutIter>
3403 class time_put_byname : public time_put<_CharT, _OutIter>
3407 typedef _CharT char_type;
3408 typedef _OutIter iter_type;
3411 time_put_byname(const char*, size_t __refs = 0)
3412 : time_put<_CharT, _OutIter>(__refs)
3417 ~time_put_byname() { }
3422 * @brief Money format ordering data.
3424 * This class contains an ordered array of 4 fields to represent the
3425 * pattern for formatting a money amount. Each field may contain one entry
3426 * from the part enum. symbol, sign, and value must be present and the
3427 * remaining field must contain either none or space. @see
3428 * moneypunct::pos_format() and moneypunct::neg_format() for details of how
3429 * these fields are interpreted.
3434 enum part { none, space, symbol, sign, value };
3435 struct pattern { char field[4]; };
3437 static const pattern _S_default_pattern;
3446 // String literal of acceptable (narrow) input/output, for
3447 // money_get/money_put. "-0123456789"
3448 static const char* _S_atoms;
3450 // Construct and return valid pattern consisting of some combination of:
3451 // space none symbol sign value
3453 _S_construct_pattern(char __precedes, char __space, char __posn);
3456 template<typename _CharT, bool _Intl>
3457 struct __moneypunct_cache : public locale::facet
3459 const char* _M_grouping;
3460 size_t _M_grouping_size;
3461 bool _M_use_grouping;
3462 _CharT _M_decimal_point;
3463 _CharT _M_thousands_sep;
3464 const _CharT* _M_curr_symbol;
3465 size_t _M_curr_symbol_size;
3466 const _CharT* _M_positive_sign;
3467 size_t _M_positive_sign_size;
3468 const _CharT* _M_negative_sign;
3469 size_t _M_negative_sign_size;
3471 money_base::pattern _M_pos_format;
3472 money_base::pattern _M_neg_format;
3474 // A list of valid numeric literals for input and output: in the standard
3475 // "C" locale, this is "-0123456789". This array contains the chars after
3476 // having been passed through the current locale's ctype<_CharT>.widen().
3477 _CharT _M_atoms[money_base::_S_end];
3481 __moneypunct_cache(size_t __refs = 0) : facet(__refs),
3482 _M_grouping(NULL), _M_grouping_size(0), _M_use_grouping(false),
3483 _M_decimal_point(_CharT()), _M_thousands_sep(_CharT()),
3484 _M_curr_symbol(NULL), _M_curr_symbol_size(0),
3485 _M_positive_sign(NULL), _M_positive_sign_size(0),
3486 _M_negative_sign(NULL), _M_negative_sign_size(0),
3488 _M_pos_format(money_base::pattern()),
3489 _M_neg_format(money_base::pattern()), _M_allocated(false)
3492 ~__moneypunct_cache();
3495 _M_cache(const locale& __loc);
3498 template<typename _CharT, bool _Intl>
3499 __moneypunct_cache<_CharT, _Intl>::~__moneypunct_cache()
3503 delete [] _M_grouping;
3504 delete [] _M_curr_symbol;
3505 delete [] _M_positive_sign;
3506 delete [] _M_negative_sign;
3511 * @brief Facet for formatting data for money amounts.
3513 * This facet encapsulates the punctuation, grouping and other formatting
3514 * features of money amount string representations.
3516 template<typename _CharT, bool _Intl>
3517 class moneypunct : public locale::facet, public money_base
3523 typedef _CharT char_type;
3524 typedef basic_string<_CharT> string_type;
3526 typedef __moneypunct_cache<_CharT, _Intl> __cache_type;
3529 __cache_type* _M_data;
3532 /// This value is provided by the standard, but no reason for its
3534 static const bool intl = _Intl;
3535 /// Numpunct facet id.
3536 static locale::id id;
3539 * @brief Constructor performs initialization.
3541 * This is the constructor provided by the standard.
3543 * @param refs Passed to the base facet class.
3546 moneypunct(size_t __refs = 0) : facet(__refs), _M_data(NULL)
3547 { _M_initialize_moneypunct(); }
3550 * @brief Constructor performs initialization.
3552 * This is an internal constructor.
3554 * @param cache Cache for optimization.
3555 * @param refs Passed to the base facet class.
3558 moneypunct(__cache_type* __cache, size_t __refs = 0)
3559 : facet(__refs), _M_data(__cache)
3560 { _M_initialize_moneypunct(); }
3563 * @brief Internal constructor. Not for general use.
3565 * This is a constructor for use by the library itself to set up new
3568 * @param cloc The "C" locale.
3569 * @param s The name of a locale.
3570 * @param refs Passed to the base facet class.
3573 moneypunct(__c_locale __cloc, const char* __s, size_t __refs = 0)
3574 : facet(__refs), _M_data(NULL)
3575 { _M_initialize_moneypunct(__cloc, __s); }
3578 * @brief Return decimal point character.
3580 * This function returns a char_type to use as a decimal point. It
3581 * does so by returning returning
3582 * moneypunct<char_type>::do_decimal_point().
3584 * @return @a char_type representing a decimal point.
3587 decimal_point() const
3588 { return this->do_decimal_point(); }
3591 * @brief Return thousands separator character.
3593 * This function returns a char_type to use as a thousands
3594 * separator. It does so by returning returning
3595 * moneypunct<char_type>::do_thousands_sep().
3597 * @return char_type representing a thousands separator.
3600 thousands_sep() const
3601 { return this->do_thousands_sep(); }
3604 * @brief Return grouping specification.
3606 * This function returns a string representing groupings for the
3607 * integer part of an amount. Groupings indicate where thousands
3608 * separators should be inserted.
3610 * Each char in the return string is interpret as an integer rather
3611 * than a character. These numbers represent the number of digits in a
3612 * group. The first char in the string represents the number of digits
3613 * in the least significant group. If a char is negative, it indicates
3614 * an unlimited number of digits for the group. If more chars from the
3615 * string are required to group a number, the last char is used
3618 * For example, if the grouping() returns "\003\002" and is applied to
3619 * the number 123456789, this corresponds to 12,34,56,789. Note that
3620 * if the string was "32", this would put more than 50 digits into the
3621 * least significant group if the character set is ASCII.
3623 * The string is returned by calling
3624 * moneypunct<char_type>::do_grouping().
3626 * @return string representing grouping specification.
3630 { return this->do_grouping(); }
3633 * @brief Return currency symbol string.
3635 * This function returns a string_type to use as a currency symbol. It
3636 * does so by returning returning
3637 * moneypunct<char_type>::do_curr_symbol().
3639 * @return @a string_type representing a currency symbol.
3643 { return this->do_curr_symbol(); }
3646 * @brief Return positive sign string.
3648 * This function returns a string_type to use as a sign for positive
3649 * amounts. It does so by returning returning
3650 * moneypunct<char_type>::do_positive_sign().
3652 * If the return value contains more than one character, the first
3653 * character appears in the position indicated by pos_format() and the
3654 * remainder appear at the end of the formatted string.
3656 * @return @a string_type representing a positive sign.
3659 positive_sign() const
3660 { return this->do_positive_sign(); }
3663 * @brief Return negative sign string.
3665 * This function returns a string_type to use as a sign for negative
3666 * amounts. It does so by returning returning
3667 * moneypunct<char_type>::do_negative_sign().
3669 * If the return value contains more than one character, the first
3670 * character appears in the position indicated by neg_format() and the
3671 * remainder appear at the end of the formatted string.
3673 * @return @a string_type representing a negative sign.
3676 negative_sign() const
3677 { return this->do_negative_sign(); }
3680 * @brief Return number of digits in fraction.
3682 * This function returns the exact number of digits that make up the
3683 * fractional part of a money amount. It does so by returning
3684 * returning moneypunct<char_type>::do_frac_digits().
3686 * The fractional part of a money amount is optional. But if it is
3687 * present, there must be frac_digits() digits.
3689 * @return Number of digits in amount fraction.
3693 { return this->do_frac_digits(); }
3697 * @brief Return pattern for money values.
3699 * This function returns a pattern describing the formatting of a
3700 * positive or negative valued money amount. It does so by returning
3701 * returning moneypunct<char_type>::do_pos_format() or
3702 * moneypunct<char_type>::do_neg_format().
3704 * The pattern has 4 fields describing the ordering of symbol, sign,
3705 * value, and none or space. There must be one of each in the pattern.
3706 * The none and space enums may not appear in the first field and space
3707 * may not appear in the final field.
3709 * The parts of a money string must appear in the order indicated by
3710 * the fields of the pattern. The symbol field indicates that the
3711 * value of curr_symbol() may be present. The sign field indicates
3712 * that the value of positive_sign() or negative_sign() must be
3713 * present. The value field indicates that the absolute value of the
3714 * money amount is present. none indicates 0 or more whitespace
3715 * characters, except at the end, where it permits no whitespace.
3716 * space indicates that 1 or more whitespace characters must be
3719 * For example, for the US locale and pos_format() pattern
3720 * {symbol,sign,value,none}, curr_symbol() == '$' positive_sign() ==
3721 * '+', and value 10.01, and options set to force the symbol, the
3722 * corresponding string is "$+10.01".
3724 * @return Pattern for money values.
3728 { return this->do_pos_format(); }
3732 { return this->do_neg_format(); }
3741 * @brief Return decimal point character.
3743 * Returns a char_type to use as a decimal point. This function is a
3744 * hook for derived classes to change the value returned.
3746 * @return @a char_type representing a decimal point.
3749 do_decimal_point() const
3750 { return _M_data->_M_decimal_point; }
3753 * @brief Return thousands separator character.
3755 * Returns a char_type to use as a thousands separator. This function
3756 * is a hook for derived classes to change the value returned.
3758 * @return @a char_type representing a thousands separator.
3761 do_thousands_sep() const
3762 { return _M_data->_M_thousands_sep; }
3765 * @brief Return grouping specification.
3767 * Returns a string representing groupings for the integer part of a
3768 * number. This function is a hook for derived classes to change the
3769 * value returned. @see grouping() for details.
3771 * @return String representing grouping specification.
3775 { return _M_data->_M_grouping; }
3778 * @brief Return currency symbol string.
3780 * This function returns a string_type to use as a currency symbol.
3781 * This function is a hook for derived classes to change the value
3782 * returned. @see curr_symbol() for details.
3784 * @return @a string_type representing a currency symbol.
3787 do_curr_symbol() const
3788 { return _M_data->_M_curr_symbol; }
3791 * @brief Return positive sign string.
3793 * This function returns a string_type to use as a sign for positive
3794 * amounts. This function is a hook for derived classes to change the
3795 * value returned. @see positive_sign() for details.
3797 * @return @a string_type representing a positive sign.
3800 do_positive_sign() const
3801 { return _M_data->_M_positive_sign; }
3804 * @brief Return negative sign string.
3806 * This function returns a string_type to use as a sign for negative
3807 * amounts. This function is a hook for derived classes to change the
3808 * value returned. @see negative_sign() for details.
3810 * @return @a string_type representing a negative sign.
3813 do_negative_sign() const
3814 { return _M_data->_M_negative_sign; }
3817 * @brief Return number of digits in fraction.
3819 * This function returns the exact number of digits that make up the
3820 * fractional part of a money amount. This function is a hook for
3821 * derived classes to change the value returned. @see frac_digits()
3824 * @return Number of digits in amount fraction.
3827 do_frac_digits() const
3828 { return _M_data->_M_frac_digits; }
3831 * @brief Return pattern for money values.
3833 * This function returns a pattern describing the formatting of a
3834 * positive valued money amount. This function is a hook for derived
3835 * classes to change the value returned. @see pos_format() for
3838 * @return Pattern for money values.
3841 do_pos_format() const
3842 { return _M_data->_M_pos_format; }
3845 * @brief Return pattern for money values.
3847 * This function returns a pattern describing the formatting of a
3848 * negative valued money amount. This function is a hook for derived
3849 * classes to change the value returned. @see neg_format() for
3852 * @return Pattern for money values.
3855 do_neg_format() const
3856 { return _M_data->_M_neg_format; }
3858 // For use at construction time only.
3860 _M_initialize_moneypunct(__c_locale __cloc = NULL,
3861 const char* __name = NULL);
3864 template<typename _CharT, bool _Intl>
3865 locale::id moneypunct<_CharT, _Intl>::id;
3867 template<typename _CharT, bool _Intl>
3868 const bool moneypunct<_CharT, _Intl>::intl;
3871 moneypunct<char, true>::~moneypunct();
3874 moneypunct<char, false>::~moneypunct();
3878 moneypunct<char, true>::_M_initialize_moneypunct(__c_locale, const char*);
3882 moneypunct<char, false>::_M_initialize_moneypunct(__c_locale, const char*);
3884 #ifdef _GLIBCXX_USE_WCHAR_T
3886 moneypunct<wchar_t, true>::~moneypunct();
3889 moneypunct<wchar_t, false>::~moneypunct();
3893 moneypunct<wchar_t, true>::_M_initialize_moneypunct(__c_locale,
3898 moneypunct<wchar_t, false>::_M_initialize_moneypunct(__c_locale,
3902 template<typename _CharT, bool _Intl>
3903 class moneypunct_byname : public moneypunct<_CharT, _Intl>
3906 typedef _CharT char_type;
3907 typedef basic_string<_CharT> string_type;
3909 static const bool intl = _Intl;
3912 moneypunct_byname(const char* __s, size_t __refs = 0)
3913 : moneypunct<_CharT, _Intl>(__refs)
3915 if (std::strcmp(__s, "C") != 0 && std::strcmp(__s, "POSIX") != 0)
3918 this->_S_create_c_locale(__tmp, __s);
3919 this->_M_initialize_moneypunct(__tmp);
3920 this->_S_destroy_c_locale(__tmp);
3926 ~moneypunct_byname() { }
3929 template<typename _CharT, bool _Intl>
3930 const bool moneypunct_byname<_CharT, _Intl>::intl;
3933 * @brief Facet for parsing monetary amounts.
3935 * This facet encapsulates the code to parse and return a monetary
3936 * amount from a string.
3938 * The money_get template uses protected virtual functions to
3939 * provide the actual results. The public accessors forward the
3940 * call to the virtual functions. These virtual functions are
3941 * hooks for developers to implement the behavior they require from
3942 * the money_get facet.
3944 template<typename _CharT, typename _InIter>
3945 class money_get : public locale::facet
3951 typedef _CharT char_type;
3952 typedef _InIter iter_type;
3953 typedef basic_string<_CharT> string_type;
3956 /// Numpunct facet id.
3957 static locale::id id;
3960 * @brief Constructor performs initialization.
3962 * This is the constructor provided by the standard.
3964 * @param refs Passed to the base facet class.
3967 money_get(size_t __refs = 0) : facet(__refs) { }
3970 * @brief Read and parse a monetary value.
3972 * This function reads characters from @a s, interprets them as a
3973 * monetary value according to moneypunct and ctype facets retrieved
3974 * from io.getloc(), and returns the result in @a units as an integral
3975 * value moneypunct::frac_digits() * the actual amount. For example,
3976 * the string $10.01 in a US locale would store 1001 in @a units.
3978 * Any characters not part of a valid money amount are not consumed.
3980 * If a money value cannot be parsed from the input stream, sets
3981 * err=(err|io.failbit). If the stream is consumed before finishing
3982 * parsing, sets err=(err|io.failbit|io.eofbit). @a units is
3983 * unchanged if parsing fails.
3985 * This function works by returning the result of do_get().
3987 * @param s Start of characters to parse.
3988 * @param end End of characters to parse.
3989 * @param intl Parameter to use_facet<moneypunct<CharT,intl> >.
3990 * @param io Source of facets and io state.
3991 * @param err Error field to set if parsing fails.
3992 * @param units Place to store result of parsing.
3993 * @return Iterator referencing first character beyond valid money
3997 get(iter_type __s, iter_type __end, bool __intl, ios_base& __io,
3998 ios_base::iostate& __err, long double& __units) const
3999 { return this->do_get(__s, __end, __intl, __io, __err, __units); }
4002 * @brief Read and parse a monetary value.
4004 * This function reads characters from @a s, interprets them as a
4005 * monetary value according to moneypunct and ctype facets retrieved
4006 * from io.getloc(), and returns the result in @a digits. For example,
4007 * the string $10.01 in a US locale would store "1001" in @a digits.
4009 * Any characters not part of a valid money amount are not consumed.
4011 * If a money value cannot be parsed from the input stream, sets
4012 * err=(err|io.failbit). If the stream is consumed before finishing
4013 * parsing, sets err=(err|io.failbit|io.eofbit).
4015 * This function works by returning the result of do_get().
4017 * @param s Start of characters to parse.
4018 * @param end End of characters to parse.
4019 * @param intl Parameter to use_facet<moneypunct<CharT,intl> >.
4020 * @param io Source of facets and io state.
4021 * @param err Error field to set if parsing fails.
4022 * @param digits Place to store result of parsing.
4023 * @return Iterator referencing first character beyond valid money
4027 get(iter_type __s, iter_type __end, bool __intl, ios_base& __io,
4028 ios_base::iostate& __err, string_type& __digits) const
4029 { return this->do_get(__s, __end, __intl, __io, __err, __digits); }
4037 * @brief Read and parse a monetary value.
4039 * This function reads and parses characters representing a monetary
4040 * value. This function is a hook for derived classes to change the
4041 * value returned. @see get() for details.
4044 do_get(iter_type __s, iter_type __end, bool __intl, ios_base& __io,
4045 ios_base::iostate& __err, long double& __units) const;
4048 * @brief Read and parse a monetary value.
4050 * This function reads and parses characters representing a monetary
4051 * value. This function is a hook for derived classes to change the
4052 * value returned. @see get() for details.
4055 do_get(iter_type __s, iter_type __end, bool __intl, ios_base& __io,
4056 ios_base::iostate& __err, string_type& __digits) const;
4058 template<bool _Intl>
4060 _M_extract(iter_type __s, iter_type __end, ios_base& __io,
4061 ios_base::iostate& __err, string& __digits) const;
4064 template<typename _CharT, typename _InIter>
4065 locale::id money_get<_CharT, _InIter>::id;
4068 * @brief Facet for outputting monetary amounts.
4070 * This facet encapsulates the code to format and output a monetary
4073 * The money_put template uses protected virtual functions to
4074 * provide the actual results. The public accessors forward the
4075 * call to the virtual functions. These virtual functions are
4076 * hooks for developers to implement the behavior they require from
4077 * the money_put facet.
4079 template<typename _CharT, typename _OutIter>
4080 class money_put : public locale::facet
4085 typedef _CharT char_type;
4086 typedef _OutIter iter_type;
4087 typedef basic_string<_CharT> string_type;
4090 /// Numpunct facet id.
4091 static locale::id id;
4094 * @brief Constructor performs initialization.
4096 * This is the constructor provided by the standard.
4098 * @param refs Passed to the base facet class.
4101 money_put(size_t __refs = 0) : facet(__refs) { }
4104 * @brief Format and output a monetary value.
4106 * This function formats @a units as a monetary value according to
4107 * moneypunct and ctype facets retrieved from io.getloc(), and writes
4108 * the resulting characters to @a s. For example, the value 1001 in a
4109 * US locale would write "$10.01" to @a s.
4111 * This function works by returning the result of do_put().
4113 * @param s The stream to write to.
4114 * @param intl Parameter to use_facet<moneypunct<CharT,intl> >.
4115 * @param io Source of facets and io state.
4116 * @param fill char_type to use for padding.
4117 * @param units Place to store result of parsing.
4118 * @return Iterator after writing.
4121 put(iter_type __s, bool __intl, ios_base& __io,
4122 char_type __fill, long double __units) const
4123 { return this->do_put(__s, __intl, __io, __fill, __units); }
4126 * @brief Format and output a monetary value.
4128 * This function formats @a digits as a monetary value according to
4129 * moneypunct and ctype facets retrieved from io.getloc(), and writes
4130 * the resulting characters to @a s. For example, the string "1001" in
4131 * a US locale would write "$10.01" to @a s.
4133 * This function works by returning the result of do_put().
4135 * @param s The stream to write to.
4136 * @param intl Parameter to use_facet<moneypunct<CharT,intl> >.
4137 * @param io Source of facets and io state.
4138 * @param fill char_type to use for padding.
4139 * @param units Place to store result of parsing.
4140 * @return Iterator after writing.
4143 put(iter_type __s, bool __intl, ios_base& __io,
4144 char_type __fill, const string_type& __digits) const
4145 { return this->do_put(__s, __intl, __io, __fill, __digits); }
4153 * @brief Format and output a monetary value.
4155 * This function formats @a units as a monetary value according to
4156 * moneypunct and ctype facets retrieved from io.getloc(), and writes
4157 * the resulting characters to @a s. For example, the value 1001 in a
4158 * US locale would write "$10.01" to @a s.
4160 * This function is a hook for derived classes to change the value
4161 * returned. @see put().
4163 * @param s The stream to write to.
4164 * @param intl Parameter to use_facet<moneypunct<CharT,intl> >.
4165 * @param io Source of facets and io state.
4166 * @param fill char_type to use for padding.
4167 * @param units Place to store result of parsing.
4168 * @return Iterator after writing.
4171 do_put(iter_type __s, bool __intl, ios_base& __io, char_type __fill,
4172 long double __units) const;
4175 * @brief Format and output a monetary value.
4177 * This function formats @a digits as a monetary value according to
4178 * moneypunct and ctype facets retrieved from io.getloc(), and writes
4179 * the resulting characters to @a s. For example, the string "1001" in
4180 * a US locale would write "$10.01" to @a s.
4182 * This function is a hook for derived classes to change the value
4183 * returned. @see put().
4185 * @param s The stream to write to.
4186 * @param intl Parameter to use_facet<moneypunct<CharT,intl> >.
4187 * @param io Source of facets and io state.
4188 * @param fill char_type to use for padding.
4189 * @param units Place to store result of parsing.
4190 * @return Iterator after writing.
4193 do_put(iter_type __s, bool __intl, ios_base& __io, char_type __fill,
4194 const string_type& __digits) const;
4196 template<bool _Intl>
4198 _M_insert(iter_type __s, ios_base& __io, char_type __fill,
4199 const string_type& __digits) const;
4202 template<typename _CharT, typename _OutIter>
4203 locale::id money_put<_CharT, _OutIter>::id;
4206 * @brief Messages facet base class providing catalog typedef.
4208 struct messages_base
4210 typedef int catalog;
4214 * @brief Facet for handling message catalogs
4216 * This facet encapsulates the code to retrieve messages from
4217 * message catalogs. The only thing defined by the standard for this facet
4218 * is the interface. All underlying functionality is
4219 * implementation-defined.
4221 * This library currently implements 3 versions of the message facet. The
4222 * first version (gnu) is a wrapper around gettext, provided by libintl.
4223 * The second version (ieee) is a wrapper around catgets. The final
4224 * version (default) does no actual translation. These implementations are
4225 * only provided for char and wchar_t instantiations.
4227 * The messages template uses protected virtual functions to
4228 * provide the actual results. The public accessors forward the
4229 * call to the virtual functions. These virtual functions are
4230 * hooks for developers to implement the behavior they require from
4231 * the messages facet.
4233 template<typename _CharT>
4234 class messages : public locale::facet, public messages_base
4240 typedef _CharT char_type;
4241 typedef basic_string<_CharT> string_type;
4245 // Underlying "C" library locale information saved from
4246 // initialization, needed by messages_byname as well.
4247 __c_locale _M_c_locale_messages;
4248 const char* _M_name_messages;
4251 /// Numpunct facet id.
4252 static locale::id id;
4255 * @brief Constructor performs initialization.
4257 * This is the constructor provided by the standard.
4259 * @param refs Passed to the base facet class.
4262 messages(size_t __refs = 0);
4266 * @brief Internal constructor. Not for general use.
4268 * This is a constructor for use by the library itself to set up new
4271 * @param cloc The "C" locale.
4272 * @param s The name of a locale.
4273 * @param refs Refcount to pass to the base class.
4276 messages(__c_locale __cloc, const char* __s, size_t __refs = 0);
4279 * @brief Open a message catalog.
4281 * This function opens and returns a handle to a message catalog by
4282 * returning do_open(s, loc).
4284 * @param s The catalog to open.
4285 * @param loc Locale to use for character set conversions.
4286 * @return Handle to the catalog or value < 0 if open fails.
4289 open(const basic_string<char>& __s, const locale& __loc) const
4290 { return this->do_open(__s, __loc); }
4292 // Non-standard and unorthodox, yet effective.
4294 * @brief Open a message catalog.
4296 * This non-standard function opens and returns a handle to a message
4297 * catalog by returning do_open(s, loc). The third argument provides a
4298 * message catalog root directory for gnu gettext and is ignored
4301 * @param s The catalog to open.
4302 * @param loc Locale to use for character set conversions.
4303 * @param dir Message catalog root directory.
4304 * @return Handle to the catalog or value < 0 if open fails.
4307 open(const basic_string<char>&, const locale&, const char*) const;
4310 * @brief Look up a string in a message catalog.
4312 * This function retrieves and returns a message from a catalog by
4313 * returning do_get(c, set, msgid, s).
4315 * For gnu, @a set and @a msgid are ignored. Returns gettext(s).
4316 * For default, returns s. For ieee, returns catgets(c,set,msgid,s).
4318 * @param c The catalog to access.
4319 * @param set Implementation-defined.
4320 * @param msgid Implementation-defined.
4321 * @param s Default return value if retrieval fails.
4322 * @return Retrieved message or @a s if get fails.
4325 get(catalog __c, int __set, int __msgid, const string_type& __s) const
4326 { return this->do_get(__c, __set, __msgid, __s); }
4329 * @brief Close a message catalog.
4331 * Closes catalog @a c by calling do_close(c).
4333 * @param c The catalog to close.
4336 close(catalog __c) const
4337 { return this->do_close(__c); }
4345 * @brief Open a message catalog.
4347 * This function opens and returns a handle to a message catalog in an
4348 * implementation-defined manner. This function is a hook for derived
4349 * classes to change the value returned.
4351 * @param s The catalog to open.
4352 * @param loc Locale to use for character set conversions.
4353 * @return Handle to the opened catalog, value < 0 if open failed.
4356 do_open(const basic_string<char>&, const locale&) const;
4359 * @brief Look up a string in a message catalog.
4361 * This function retrieves and returns a message from a catalog in an
4362 * implementation-defined manner. This function is a hook for derived
4363 * classes to change the value returned.
4365 * For gnu, @a set and @a msgid are ignored. Returns gettext(s).
4366 * For default, returns s. For ieee, returns catgets(c,set,msgid,s).
4368 * @param c The catalog to access.
4369 * @param set Implementation-defined.
4370 * @param msgid Implementation-defined.
4371 * @param s Default return value if retrieval fails.
4372 * @return Retrieved message or @a s if get fails.
4375 do_get(catalog, int, int, const string_type& __dfault) const;
4378 * @brief Close a message catalog.
4380 * @param c The catalog to close.
4383 do_close(catalog) const;
4385 // Returns a locale and codeset-converted string, given a char* message.
4387 _M_convert_to_char(const string_type& __msg) const
4390 return reinterpret_cast<char*>(const_cast<_CharT*>(__msg.c_str()));
4393 // Returns a locale and codeset-converted string, given a char* message.
4395 _M_convert_from_char(char*) const
4398 // Length of message string without terminating null.
4399 size_t __len = char_traits<char>::length(__msg) - 1;
4401 // "everybody can easily convert the string using
4402 // mbsrtowcs/wcsrtombs or with iconv()"
4404 // Convert char* to _CharT in locale used to open catalog.
4405 // XXX need additional template parameter on messages class for this..
4406 // typedef typename codecvt<char, _CharT, _StateT> __codecvt_type;
4407 typedef typename codecvt<char, _CharT, mbstate_t> __codecvt_type;
4409 __codecvt_type::state_type __state;
4410 // XXX may need to initialize state.
4411 //initialize_state(__state._M_init());
4414 // XXX what size for this string?
4415 _CharT* __to = static_cast<_CharT*>(__builtin_alloca(__len + 1));
4416 const __codecvt_type& __cvt = use_facet<__codecvt_type>(_M_locale_conv);
4417 __cvt.out(__state, __msg, __msg + __len, __from_next,
4418 __to, __to + __len + 1, __to_next);
4419 return string_type(__to);
4422 typedef ctype<_CharT> __ctype_type;
4423 // const __ctype_type& __cvt = use_facet<__ctype_type>(_M_locale_msg);
4424 const __ctype_type& __cvt = use_facet<__ctype_type>(locale());
4425 // XXX Again, proper length of converted string an issue here.
4426 // For now, assume the converted length is not larger.
4427 _CharT* __dest = static_cast<_CharT*>(__builtin_alloca(__len + 1));
4428 __cvt.widen(__msg, __msg + __len, __dest);
4429 return basic_string<_CharT>(__dest);
4431 return string_type();
4435 template<typename _CharT>
4436 locale::id messages<_CharT>::id;
4438 // Specializations for required instantiations.
4441 messages<char>::do_get(catalog, int, int, const string&) const;
4443 #ifdef _GLIBCXX_USE_WCHAR_T
4446 messages<wchar_t>::do_get(catalog, int, int, const wstring&) const;
4449 template<typename _CharT>
4450 class messages_byname : public messages<_CharT>
4453 typedef _CharT char_type;
4454 typedef basic_string<_CharT> string_type;
4457 messages_byname(const char* __s, size_t __refs = 0);
4465 // Include host and configuration specific messages functions.
4466 #include <bits/messages_members.h>
4469 // Subclause convenience interfaces, inlines.
4470 // NB: These are inline because, when used in a loop, some compilers
4471 // can hoist the body out of the loop; then it's just as fast as the
4472 // C is*() function.
4474 /// Convenience interface to ctype.is().
4475 template<typename _CharT>
4477 isspace(_CharT __c, const locale& __loc)
4478 { return use_facet<ctype<_CharT> >(__loc).is(ctype_base::space, __c); }
4480 template<typename _CharT>
4482 isprint(_CharT __c, const locale& __loc)
4483 { return use_facet<ctype<_CharT> >(__loc).is(ctype_base::print, __c); }
4485 template<typename _CharT>
4487 iscntrl(_CharT __c, const locale& __loc)
4488 { return use_facet<ctype<_CharT> >(__loc).is(ctype_base::cntrl, __c); }
4490 template<typename _CharT>
4492 isupper(_CharT __c, const locale& __loc)
4493 { return use_facet<ctype<_CharT> >(__loc).is(ctype_base::upper, __c); }
4495 template<typename _CharT>
4496 inline bool islower(_CharT __c, const locale& __loc)
4497 { return use_facet<ctype<_CharT> >(__loc).is(ctype_base::lower, __c); }
4499 template<typename _CharT>
4501 isalpha(_CharT __c, const locale& __loc)
4502 { return use_facet<ctype<_CharT> >(__loc).is(ctype_base::alpha, __c); }
4504 template<typename _CharT>
4506 isdigit(_CharT __c, const locale& __loc)
4507 { return use_facet<ctype<_CharT> >(__loc).is(ctype_base::digit, __c); }
4509 template<typename _CharT>
4511 ispunct(_CharT __c, const locale& __loc)
4512 { return use_facet<ctype<_CharT> >(__loc).is(ctype_base::punct, __c); }
4514 template<typename _CharT>
4516 isxdigit(_CharT __c, const locale& __loc)
4517 { return use_facet<ctype<_CharT> >(__loc).is(ctype_base::xdigit, __c); }
4519 template<typename _CharT>
4521 isalnum(_CharT __c, const locale& __loc)
4522 { return use_facet<ctype<_CharT> >(__loc).is(ctype_base::alnum, __c); }
4524 template<typename _CharT>
4526 isgraph(_CharT __c, const locale& __loc)
4527 { return use_facet<ctype<_CharT> >(__loc).is(ctype_base::graph, __c); }
4529 template<typename _CharT>
4531 toupper(_CharT __c, const locale& __loc)
4532 { return use_facet<ctype<_CharT> >(__loc).toupper(__c); }
4534 template<typename _CharT>
4536 tolower(_CharT __c, const locale& __loc)
4537 { return use_facet<ctype<_CharT> >(__loc).tolower(__c); }