1 // Character Traits for use by standard string and iostream -*- C++ -*-
3 // Copyright (C) 1997-2015 Free Software Foundation, Inc.
5 // This file is part of the GNU ISO C++ Library. This library is free
6 // software; you can redistribute it and/or modify it under the
7 // terms of the GNU General Public License as published by the
8 // Free Software Foundation; either version 3, or (at your option)
11 // This library is distributed in the hope that it will be useful,
12 // but WITHOUT ANY WARRANTY; without even the implied warranty of
13 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 // GNU General Public License for more details.
16 // Under Section 7 of GPL version 3, you are granted additional
17 // permissions described in the GCC Runtime Library Exception, version
18 // 3.1, as published by the Free Software Foundation.
20 // You should have received a copy of the GNU General Public License and
21 // a copy of the GCC Runtime Library Exception along with this program;
22 // see the files COPYING3 and COPYING.RUNTIME respectively. If not, see
23 // <http://www.gnu.org/licenses/>.
25 /** @file bits/char_traits.h
26 * This is an internal header file, included by other library headers.
27 * Do not attempt to use it directly. @headername{string}
31 // ISO C++ 14882: 21 Strings library
34 #ifndef _CHAR_TRAITS_H
35 #define _CHAR_TRAITS_H 1
37 #pragma GCC system_header
39 #include <bits/stl_algobase.h> // std::copy, std::fill_n
40 #include <bits/postypes.h> // For streampos
41 #include <cwchar> // For WEOF, wmemmove, wmemset, etc.
43 namespace __gnu_cxx
_GLIBCXX_VISIBILITY(default)
45 _GLIBCXX_BEGIN_NAMESPACE_VERSION
48 * @brief Mapping from character type to associated types.
50 * @note This is an implementation class for the generic version
51 * of char_traits. It defines int_type, off_type, pos_type, and
52 * state_type. By default these are unsigned long, streamoff,
53 * streampos, and mbstate_t. Users who need a different set of
54 * types, but who don't need to change the definitions of any function
55 * defined in char_traits, can specialize __gnu_cxx::_Char_types
56 * while leaving __gnu_cxx::char_traits alone. */
57 template<typename _CharT
>
60 typedef unsigned long int_type
;
61 typedef std::streampos pos_type
;
62 typedef std::streamoff off_type
;
63 typedef std::mbstate_t state_type
;
68 * @brief Base class used to implement std::char_traits.
70 * @note For any given actual character type, this definition is
71 * probably wrong. (Most of the member functions are likely to be
72 * right, but the int_type and state_type typedefs, and the eof()
73 * member function, are likely to be wrong.) The reason this class
74 * exists is so users can specialize it. Classes in namespace std
75 * may not be specialized for fundamental types, but classes in
76 * namespace __gnu_cxx may be.
78 * See https://gcc.gnu.org/onlinedocs/libstdc++/manual/strings.html#strings.string.character_types
79 * for advice on how to make use of this class for @a unusual character
80 * types. Also, check out include/ext/pod_char_traits.h.
82 template<typename _CharT
>
85 typedef _CharT char_type
;
86 typedef typename _Char_types
<_CharT
>::int_type int_type
;
87 typedef typename _Char_types
<_CharT
>::pos_type pos_type
;
88 typedef typename _Char_types
<_CharT
>::off_type off_type
;
89 typedef typename _Char_types
<_CharT
>::state_type state_type
;
92 assign(char_type
& __c1
, const char_type
& __c2
)
95 static _GLIBCXX_CONSTEXPR
bool
96 eq(const char_type
& __c1
, const char_type
& __c2
)
97 { return __c1
== __c2
; }
99 static _GLIBCXX_CONSTEXPR
bool
100 lt(const char_type
& __c1
, const char_type
& __c2
)
101 { return __c1
< __c2
; }
104 compare(const char_type
* __s1
, const char_type
* __s2
, std::size_t __n
);
107 length(const char_type
* __s
);
109 static const char_type
*
110 find(const char_type
* __s
, std::size_t __n
, const char_type
& __a
);
113 move(char_type
* __s1
, const char_type
* __s2
, std::size_t __n
);
116 copy(char_type
* __s1
, const char_type
* __s2
, std::size_t __n
);
119 assign(char_type
* __s
, std::size_t __n
, char_type __a
);
121 static _GLIBCXX_CONSTEXPR char_type
122 to_char_type(const int_type
& __c
)
123 { return static_cast<char_type
>(__c
); }
125 static _GLIBCXX_CONSTEXPR int_type
126 to_int_type(const char_type
& __c
)
127 { return static_cast<int_type
>(__c
); }
129 static _GLIBCXX_CONSTEXPR
bool
130 eq_int_type(const int_type
& __c1
, const int_type
& __c2
)
131 { return __c1
== __c2
; }
133 static _GLIBCXX_CONSTEXPR int_type
135 { return static_cast<int_type
>(_GLIBCXX_STDIO_EOF
); }
137 static _GLIBCXX_CONSTEXPR int_type
138 not_eof(const int_type
& __c
)
139 { return !eq_int_type(__c
, eof()) ? __c
: to_int_type(char_type()); }
142 template<typename _CharT
>
144 char_traits
<_CharT
>::
145 compare(const char_type
* __s1
, const char_type
* __s2
, std::size_t __n
)
147 for (std::size_t __i
= 0; __i
< __n
; ++__i
)
148 if (lt(__s1
[__i
], __s2
[__i
]))
150 else if (lt(__s2
[__i
], __s1
[__i
]))
155 template<typename _CharT
>
157 char_traits
<_CharT
>::
158 length(const char_type
* __p
)
161 while (!eq(__p
[__i
], char_type()))
166 template<typename _CharT
>
167 const typename char_traits
<_CharT
>::char_type
*
168 char_traits
<_CharT
>::
169 find(const char_type
* __s
, std::size_t __n
, const char_type
& __a
)
171 for (std::size_t __i
= 0; __i
< __n
; ++__i
)
172 if (eq(__s
[__i
], __a
))
177 template<typename _CharT
>
178 typename char_traits
<_CharT
>::char_type
*
179 char_traits
<_CharT
>::
180 move(char_type
* __s1
, const char_type
* __s2
, std::size_t __n
)
182 return static_cast<_CharT
*>(__builtin_memmove(__s1
, __s2
,
183 __n
* sizeof(char_type
)));
186 template<typename _CharT
>
187 typename char_traits
<_CharT
>::char_type
*
188 char_traits
<_CharT
>::
189 copy(char_type
* __s1
, const char_type
* __s2
, std::size_t __n
)
191 // NB: Inline std::copy so no recursive dependencies.
192 std::copy(__s2
, __s2
+ __n
, __s1
);
196 template<typename _CharT
>
197 typename char_traits
<_CharT
>::char_type
*
198 char_traits
<_CharT
>::
199 assign(char_type
* __s
, std::size_t __n
, char_type __a
)
201 // NB: Inline std::fill_n so no recursive dependencies.
202 std::fill_n(__s
, __n
, __a
);
206 _GLIBCXX_END_NAMESPACE_VERSION
209 namespace std
_GLIBCXX_VISIBILITY(default)
211 _GLIBCXX_BEGIN_NAMESPACE_VERSION
215 * @brief Basis for explicit traits specializations.
217 * @note For any given actual character type, this definition is
218 * probably wrong. Since this is just a thin wrapper around
219 * __gnu_cxx::char_traits, it is possible to achieve a more
220 * appropriate definition by specializing __gnu_cxx::char_traits.
222 * See https://gcc.gnu.org/onlinedocs/libstdc++/manual/strings.html#strings.string.character_types
223 * for advice on how to make use of this class for @a unusual character
224 * types. Also, check out include/ext/pod_char_traits.h.
226 template<class _CharT
>
227 struct char_traits
: public __gnu_cxx::char_traits
<_CharT
>
231 /// 21.1.3.1 char_traits specializations
233 struct char_traits
<char>
235 typedef char char_type
;
236 typedef int int_type
;
237 typedef streampos pos_type
;
238 typedef streamoff off_type
;
239 typedef mbstate_t state_type
;
242 assign(char_type
& __c1
, const char_type
& __c2
) _GLIBCXX_NOEXCEPT
245 static _GLIBCXX_CONSTEXPR
bool
246 eq(const char_type
& __c1
, const char_type
& __c2
) _GLIBCXX_NOEXCEPT
247 { return __c1
== __c2
; }
249 static _GLIBCXX_CONSTEXPR
bool
250 lt(const char_type
& __c1
, const char_type
& __c2
) _GLIBCXX_NOEXCEPT
253 return (static_cast<unsigned char>(__c1
)
254 < static_cast<unsigned char>(__c2
));
258 compare(const char_type
* __s1
, const char_type
* __s2
, size_t __n
)
262 return __builtin_memcmp(__s1
, __s2
, __n
);
266 length(const char_type
* __s
)
267 { return __builtin_strlen(__s
); }
269 static const char_type
*
270 find(const char_type
* __s
, size_t __n
, const char_type
& __a
)
274 return static_cast<const char_type
*>(__builtin_memchr(__s
, __a
, __n
));
278 move(char_type
* __s1
, const char_type
* __s2
, size_t __n
)
282 return static_cast<char_type
*>(__builtin_memmove(__s1
, __s2
, __n
));
286 copy(char_type
* __s1
, const char_type
* __s2
, size_t __n
)
290 return static_cast<char_type
*>(__builtin_memcpy(__s1
, __s2
, __n
));
294 assign(char_type
* __s
, size_t __n
, char_type __a
)
298 return static_cast<char_type
*>(__builtin_memset(__s
, __a
, __n
));
301 static _GLIBCXX_CONSTEXPR char_type
302 to_char_type(const int_type
& __c
) _GLIBCXX_NOEXCEPT
303 { return static_cast<char_type
>(__c
); }
305 // To keep both the byte 0xff and the eof symbol 0xffffffff
306 // from ending up as 0xffffffff.
307 static _GLIBCXX_CONSTEXPR int_type
308 to_int_type(const char_type
& __c
) _GLIBCXX_NOEXCEPT
309 { return static_cast<int_type
>(static_cast<unsigned char>(__c
)); }
311 static _GLIBCXX_CONSTEXPR
bool
312 eq_int_type(const int_type
& __c1
, const int_type
& __c2
) _GLIBCXX_NOEXCEPT
313 { return __c1
== __c2
; }
315 static _GLIBCXX_CONSTEXPR int_type
316 eof() _GLIBCXX_NOEXCEPT
317 { return static_cast<int_type
>(_GLIBCXX_STDIO_EOF
); }
319 static _GLIBCXX_CONSTEXPR int_type
320 not_eof(const int_type
& __c
) _GLIBCXX_NOEXCEPT
321 { return (__c
== eof()) ? 0 : __c
; }
325 #ifdef _GLIBCXX_USE_WCHAR_T
326 /// 21.1.3.2 char_traits specializations
328 struct char_traits
<wchar_t>
330 typedef wchar_t char_type
;
331 typedef wint_t int_type
;
332 typedef streamoff off_type
;
333 typedef wstreampos pos_type
;
334 typedef mbstate_t state_type
;
337 assign(char_type
& __c1
, const char_type
& __c2
) _GLIBCXX_NOEXCEPT
340 static _GLIBCXX_CONSTEXPR
bool
341 eq(const char_type
& __c1
, const char_type
& __c2
) _GLIBCXX_NOEXCEPT
342 { return __c1
== __c2
; }
344 static _GLIBCXX_CONSTEXPR
bool
345 lt(const char_type
& __c1
, const char_type
& __c2
) _GLIBCXX_NOEXCEPT
346 { return __c1
< __c2
; }
349 compare(const char_type
* __s1
, const char_type
* __s2
, size_t __n
)
353 return wmemcmp(__s1
, __s2
, __n
);
357 length(const char_type
* __s
)
358 { return wcslen(__s
); }
360 static const char_type
*
361 find(const char_type
* __s
, size_t __n
, const char_type
& __a
)
365 return wmemchr(__s
, __a
, __n
);
369 move(char_type
* __s1
, const char_type
* __s2
, size_t __n
)
373 return wmemmove(__s1
, __s2
, __n
);
377 copy(char_type
* __s1
, const char_type
* __s2
, size_t __n
)
381 return wmemcpy(__s1
, __s2
, __n
);
385 assign(char_type
* __s
, size_t __n
, char_type __a
)
389 return wmemset(__s
, __a
, __n
);
392 static _GLIBCXX_CONSTEXPR char_type
393 to_char_type(const int_type
& __c
) _GLIBCXX_NOEXCEPT
394 { return char_type(__c
); }
396 static _GLIBCXX_CONSTEXPR int_type
397 to_int_type(const char_type
& __c
) _GLIBCXX_NOEXCEPT
398 { return int_type(__c
); }
400 static _GLIBCXX_CONSTEXPR
bool
401 eq_int_type(const int_type
& __c1
, const int_type
& __c2
) _GLIBCXX_NOEXCEPT
402 { return __c1
== __c2
; }
404 static _GLIBCXX_CONSTEXPR int_type
405 eof() _GLIBCXX_NOEXCEPT
406 { return static_cast<int_type
>(WEOF
); }
408 static _GLIBCXX_CONSTEXPR int_type
409 not_eof(const int_type
& __c
) _GLIBCXX_NOEXCEPT
410 { return eq_int_type(__c
, eof()) ? 0 : __c
; }
412 #endif //_GLIBCXX_USE_WCHAR_T
414 _GLIBCXX_END_NAMESPACE_VERSION
417 #if ((__cplusplus >= 201103L) \
418 && defined(_GLIBCXX_USE_C99_STDINT_TR1))
422 namespace std
_GLIBCXX_VISIBILITY(default)
424 _GLIBCXX_BEGIN_NAMESPACE_VERSION
427 struct char_traits
<char16_t
>
429 typedef char16_t char_type
;
430 typedef uint_least16_t int_type
;
431 typedef streamoff off_type
;
432 typedef u16streampos pos_type
;
433 typedef mbstate_t state_type
;
436 assign(char_type
& __c1
, const char_type
& __c2
) noexcept
439 static constexpr bool
440 eq(const char_type
& __c1
, const char_type
& __c2
) noexcept
441 { return __c1
== __c2
; }
443 static constexpr bool
444 lt(const char_type
& __c1
, const char_type
& __c2
) noexcept
445 { return __c1
< __c2
; }
448 compare(const char_type
* __s1
, const char_type
* __s2
, size_t __n
)
450 for (size_t __i
= 0; __i
< __n
; ++__i
)
451 if (lt(__s1
[__i
], __s2
[__i
]))
453 else if (lt(__s2
[__i
], __s1
[__i
]))
459 length(const char_type
* __s
)
462 while (!eq(__s
[__i
], char_type()))
467 static const char_type
*
468 find(const char_type
* __s
, size_t __n
, const char_type
& __a
)
470 for (size_t __i
= 0; __i
< __n
; ++__i
)
471 if (eq(__s
[__i
], __a
))
477 move(char_type
* __s1
, const char_type
* __s2
, size_t __n
)
481 return (static_cast<char_type
*>
482 (__builtin_memmove(__s1
, __s2
, __n
* sizeof(char_type
))));
486 copy(char_type
* __s1
, const char_type
* __s2
, size_t __n
)
490 return (static_cast<char_type
*>
491 (__builtin_memcpy(__s1
, __s2
, __n
* sizeof(char_type
))));
495 assign(char_type
* __s
, size_t __n
, char_type __a
)
497 for (size_t __i
= 0; __i
< __n
; ++__i
)
498 assign(__s
[__i
], __a
);
502 static constexpr char_type
503 to_char_type(const int_type
& __c
) noexcept
504 { return char_type(__c
); }
506 static constexpr int_type
507 to_int_type(const char_type
& __c
) noexcept
508 { return int_type(__c
); }
510 static constexpr bool
511 eq_int_type(const int_type
& __c1
, const int_type
& __c2
) noexcept
512 { return __c1
== __c2
; }
514 static constexpr int_type
516 { return static_cast<int_type
>(-1); }
518 static constexpr int_type
519 not_eof(const int_type
& __c
) noexcept
520 { return eq_int_type(__c
, eof()) ? 0 : __c
; }
524 struct char_traits
<char32_t
>
526 typedef char32_t char_type
;
527 typedef uint_least32_t int_type
;
528 typedef streamoff off_type
;
529 typedef u32streampos pos_type
;
530 typedef mbstate_t state_type
;
533 assign(char_type
& __c1
, const char_type
& __c2
) noexcept
536 static constexpr bool
537 eq(const char_type
& __c1
, const char_type
& __c2
) noexcept
538 { return __c1
== __c2
; }
540 static constexpr bool
541 lt(const char_type
& __c1
, const char_type
& __c2
) noexcept
542 { return __c1
< __c2
; }
545 compare(const char_type
* __s1
, const char_type
* __s2
, size_t __n
)
547 for (size_t __i
= 0; __i
< __n
; ++__i
)
548 if (lt(__s1
[__i
], __s2
[__i
]))
550 else if (lt(__s2
[__i
], __s1
[__i
]))
556 length(const char_type
* __s
)
559 while (!eq(__s
[__i
], char_type()))
564 static const char_type
*
565 find(const char_type
* __s
, size_t __n
, const char_type
& __a
)
567 for (size_t __i
= 0; __i
< __n
; ++__i
)
568 if (eq(__s
[__i
], __a
))
574 move(char_type
* __s1
, const char_type
* __s2
, size_t __n
)
578 return (static_cast<char_type
*>
579 (__builtin_memmove(__s1
, __s2
, __n
* sizeof(char_type
))));
583 copy(char_type
* __s1
, const char_type
* __s2
, size_t __n
)
587 return (static_cast<char_type
*>
588 (__builtin_memcpy(__s1
, __s2
, __n
* sizeof(char_type
))));
592 assign(char_type
* __s
, size_t __n
, char_type __a
)
594 for (size_t __i
= 0; __i
< __n
; ++__i
)
595 assign(__s
[__i
], __a
);
599 static constexpr char_type
600 to_char_type(const int_type
& __c
) noexcept
601 { return char_type(__c
); }
603 static constexpr int_type
604 to_int_type(const char_type
& __c
) noexcept
605 { return int_type(__c
); }
607 static constexpr bool
608 eq_int_type(const int_type
& __c1
, const int_type
& __c2
) noexcept
609 { return __c1
== __c2
; }
611 static constexpr int_type
613 { return static_cast<int_type
>(-1); }
615 static constexpr int_type
616 not_eof(const int_type
& __c
) noexcept
617 { return eq_int_type(__c
, eof()) ? 0 : __c
; }
620 _GLIBCXX_END_NAMESPACE_VERSION
625 #endif // _CHAR_TRAITS_H