Clang Project

include/c++/7/bits/basic_string.tcc
1// Components for manipulating sequences of characters -*- C++ -*-
2
3// Copyright (C) 1997-2017 Free Software Foundation, Inc.
4//
5// This file is part of the GNU ISO C++ Library.  This library is free
6// software; you can redistribute it and/or modify it under the
7// terms of the GNU General Public License as published by the
8// Free Software Foundation; either version 3, or (at your option)
9// any later version.
10
11// This library is distributed in the hope that it will be useful,
12// but WITHOUT ANY WARRANTY; without even the implied warranty of
13// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14// GNU General Public License for more details.
15
16// Under Section 7 of GPL version 3, you are granted additional
17// permissions described in the GCC Runtime Library Exception, version
18// 3.1, as published by the Free Software Foundation.
19
20// You should have received a copy of the GNU General Public License and
21// a copy of the GCC Runtime Library Exception along with this program;
22// see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
23// <http://www.gnu.org/licenses/>.
24
25/** @file bits/basic_string.tcc
26 *  This is an internal header file, included by other library headers.
27 *  Do not attempt to use it directly. @headername{string}
28 */
29
30//
31// ISO C++ 14882: 21  Strings library
32//
33
34// Written by Jason Merrill based upon the specification by Takanori Adachi
35// in ANSI X3J16/94-0013R2.  Rewritten by Nathan Myers to ISO-14882.
36// Non-reference-counted implementation written by Paolo Carlini and
37// updated by Jonathan Wakely for ISO-14882-2011.
38
39#ifndef _BASIC_STRING_TCC
40#define _BASIC_STRING_TCC 1
41
42#pragma GCC system_header
43
44#include <bits/cxxabi_forced.h>
45
46namespace std _GLIBCXX_VISIBILITY(default)
47{
48_GLIBCXX_BEGIN_NAMESPACE_VERSION
49
50#if _GLIBCXX_USE_CXX11_ABI
51
52  template<typename _CharT, typename _Traits, typename _Alloc>
53    const typename basic_string<_CharT, _Traits, _Alloc>::size_type
54    basic_string<_CharT, _Traits, _Alloc>::npos;
55
56  template<typename _CharT, typename _Traits, typename _Alloc>
57    void
58    basic_string<_CharT, _Traits, _Alloc>::
59    swap(basic_string& __s) _GLIBCXX_NOEXCEPT
60    {
61      if (this == &__s)
62 return;
63
64      _Alloc_traits::_S_on_swap(_M_get_allocator(), __s._M_get_allocator());
65
66      if (_M_is_local())
67 if (__s._M_is_local())
68   {
69     if (length() && __s.length())
70       {
71 _CharT __tmp_data[_S_local_capacity + 1];
72 traits_type::copy(__tmp_data, __s._M_local_buf,
73   _S_local_capacity + 1);
74 traits_type::copy(__s._M_local_buf, _M_local_buf,
75   _S_local_capacity + 1);
76 traits_type::copy(_M_local_buf, __tmp_data,
77   _S_local_capacity + 1);
78       }
79     else if (__s.length())
80       {
81 traits_type::copy(_M_local_buf, __s._M_local_buf,
82   _S_local_capacity + 1);
83 _M_length(__s.length());
84 __s._M_set_length(0);
85 return;
86       }
87     else if (length())
88       {
89 traits_type::copy(__s._M_local_buf, _M_local_buf,
90   _S_local_capacity + 1);
91 __s._M_length(length());
92 _M_set_length(0);
93 return;
94       }
95   }
96 else
97   {
98     const size_type __tmp_capacity = __s._M_allocated_capacity;
99     traits_type::copy(__s._M_local_buf, _M_local_buf,
100       _S_local_capacity + 1);
101     _M_data(__s._M_data());
102     __s._M_data(__s._M_local_buf);
103     _M_capacity(__tmp_capacity);
104   }
105      else
106 {
107   const size_type __tmp_capacity = _M_allocated_capacity;
108   if (__s._M_is_local())
109     {
110       traits_type::copy(_M_local_buf, __s._M_local_buf,
111 _S_local_capacity + 1);
112       __s._M_data(_M_data());
113       _M_data(_M_local_buf);
114     }
115   else
116     {
117       pointer __tmp_ptr = _M_data();
118       _M_data(__s._M_data());
119       __s._M_data(__tmp_ptr);
120       _M_capacity(__s._M_allocated_capacity);
121     }
122   __s._M_capacity(__tmp_capacity);
123 }
124
125      const size_type __tmp_length = length();
126      _M_length(__s.length());
127      __s._M_length(__tmp_length);
128    }
129
130  template<typename _CharT, typename _Traits, typename _Alloc>
131    typename basic_string<_CharT, _Traits, _Alloc>::pointer
132    basic_string<_CharT, _Traits, _Alloc>::
133    _M_create(size_type& __capacity, size_type __old_capacity)
134    {
135      // _GLIBCXX_RESOLVE_LIB_DEFECTS
136      // 83.  String::npos vs. string::max_size()
137      if (__capacity > max_size())
138 std::__throw_length_error(__N("basic_string::_M_create"));
139
140      // The below implements an exponential growth policy, necessary to
141      // meet amortized linear time requirements of the library: see
142      // http://gcc.gnu.org/ml/libstdc++/2001-07/msg00085.html.
143      if (__capacity > __old_capacity && __capacity < 2 * __old_capacity)
144 {
145   __capacity = 2 * __old_capacity;
146   // Never allocate a string bigger than max_size.
147   if (__capacity > max_size())
148     __capacity = max_size();
149 }
150
151      // NB: Need an array of char_type[__capacity], plus a terminating
152      // null char_type() element.
153      return _Alloc_traits::allocate(_M_get_allocator(), __capacity + 1);
154    }
155
156  // NB: This is the special case for Input Iterators, used in
157  // istreambuf_iterators, etc.
158  // Input Iterators have a cost structure very different from
159  // pointers, calling for a different coding style.
160  template<typename _CharT, typename _Traits, typename _Alloc>
161    template<typename _InIterator>
162      void
163      basic_string<_CharT, _Traits, _Alloc>::
164      _M_construct(_InIterator __beg, _InIterator __end,
165    std::input_iterator_tag)
166      {
167 size_type __len = 0;
168 size_type __capacity = size_type(_S_local_capacity);
169
170 while (__beg != __end && __len < __capacity)
171   {
172     _M_data()[__len++] = *__beg;
173     ++__beg;
174   }
175
176 __try
177   {
178     while (__beg != __end)
179       {
180 if (__len == __capacity)
181   {
182     // Allocate more space.
183     __capacity = __len + 1;
184     pointer __another = _M_create(__capacity, __len);
185     this->_S_copy(__another, _M_data(), __len);
186     _M_dispose();
187     _M_data(__another);
188     _M_capacity(__capacity);
189   }
190 _M_data()[__len++] = *__beg;
191 ++__beg;
192       }
193   }
194 __catch(...)
195   {
196     _M_dispose();
197     __throw_exception_again;
198   }
199
200 _M_set_length(__len);
201      }
202
203  template<typename _CharT, typename _Traits, typename _Alloc>
204    template<typename _InIterator>
205      void
206      basic_string<_CharT, _Traits, _Alloc>::
207      _M_construct(_InIterator __beg, _InIterator __end,
208    std::forward_iterator_tag)
209      {
210 // NB: Not required, but considered best practice.
211 if (__gnu_cxx::__is_null_pointer(__beg) && __beg != __end)
212   std::__throw_logic_error(__N("basic_string::"
213        "_M_construct null not valid"));
214
215 size_type __dnew = static_cast<size_type>(std::distance(__beg, __end));
216
217 if (__dnew > size_type(_S_local_capacity))
218   {
219     _M_data(_M_create(__dnew, size_type(0)));
220     _M_capacity(__dnew);
221   }
222
223 // Check for out_of_range and length_error exceptions.
224 __try
225   { this->_S_copy_chars(_M_data(), __beg, __end); }
226 __catch(...)
227   {
228     _M_dispose();
229     __throw_exception_again;
230   }
231
232 _M_set_length(__dnew);
233      }
234
235  template<typename _CharT, typename _Traits, typename _Alloc>
236    void
237    basic_string<_CharT, _Traits, _Alloc>::
238    _M_construct(size_type __n, _CharT __c)
239    {
240      if (__n > size_type(_S_local_capacity))
241 {
242   _M_data(_M_create(__n, size_type(0)));
243   _M_capacity(__n);
244 }
245
246      if (__n)
247 this->_S_assign(_M_data(), __n, __c);
248
249      _M_set_length(__n);
250    }
251
252  template<typename _CharT, typename _Traits, typename _Alloc>
253    void
254    basic_string<_CharT, _Traits, _Alloc>::
255    _M_assign(const basic_string& __str)
256    {
257      if (this != &__str)
258 {
259   const size_type __rsize = __str.length();
260   const size_type __capacity = capacity();
261
262   if (__rsize > __capacity)
263     {
264       size_type __new_capacity = __rsize;
265       pointer __tmp = _M_create(__new_capacity, __capacity);
266       _M_dispose();
267       _M_data(__tmp);
268       _M_capacity(__new_capacity);
269     }
270
271   if (__rsize)
272     this->_S_copy(_M_data(), __str._M_data(), __rsize);
273
274   _M_set_length(__rsize);
275 }
276    }
277
278  template<typename _CharT, typename _Traits, typename _Alloc>
279    void
280    basic_string<_CharT, _Traits, _Alloc>::
281    reserve(size_type __res)
282    {
283      // Make sure we don't shrink below the current size.
284      if (__res < length())
285 __res = length();
286
287      const size_type __capacity = capacity();
288      if (__res != __capacity)
289 {
290   if (__res > __capacity
291       || __res > size_type(_S_local_capacity))
292     {
293       pointer __tmp = _M_create(__res, __capacity);
294       this->_S_copy(__tmp, _M_data(), length() + 1);
295       _M_dispose();
296       _M_data(__tmp);
297       _M_capacity(__res);
298     }
299   else if (!_M_is_local())
300     {
301       this->_S_copy(_M_local_data(), _M_data(), length() + 1);
302       _M_destroy(__capacity);
303       _M_data(_M_local_data());
304     }
305 }
306    }
307
308  template<typename _CharT, typename _Traits, typename _Alloc>
309    void
310    basic_string<_CharT, _Traits, _Alloc>::
311    _M_mutate(size_type __pos, size_type __len1, const _CharT* __s,
312       size_type __len2)
313    {
314      const size_type __how_much = length() - __pos - __len1;
315
316      size_type __new_capacity = length() + __len2 - __len1;
317      pointer __r = _M_create(__new_capacity, capacity());
318
319      if (__pos)
320 this->_S_copy(__r, _M_data(), __pos);
321      if (__s && __len2)
322 this->_S_copy(__r + __pos, __s, __len2);
323      if (__how_much)
324 this->_S_copy(__r + __pos + __len2,
325       _M_data() + __pos + __len1, __how_much);
326
327      _M_dispose();
328      _M_data(__r);
329      _M_capacity(__new_capacity);
330    }
331
332  template<typename _CharT, typename _Traits, typename _Alloc>
333    void
334    basic_string<_CharT, _Traits, _Alloc>::
335    _M_erase(size_type __pos, size_type __n)
336    {
337      const size_type __how_much = length() - __pos - __n;
338
339      if (__how_much && __n)
340 this->_S_move(_M_data() + __pos, _M_data() + __pos + __n, __how_much);
341
342      _M_set_length(length() - __n);
343    }
344
345  template<typename _CharT, typename _Traits, typename _Alloc>
346    void
347    basic_string<_CharT, _Traits, _Alloc>::
348    resize(size_type __n, _CharT __c)
349    {
350      const size_type __size = this->size();
351      if (__size < __n)
352 this->append(__n - __size, __c);
353      else if (__n < __size)
354 this->_M_set_length(__n);
355    }
356
357  template<typename _CharT, typename _Traits, typename _Alloc>
358    basic_string<_CharT, _Traits, _Alloc>&
359    basic_string<_CharT, _Traits, _Alloc>::
360    _M_append(const _CharT* __s, size_type __n)
361    {
362      const size_type __len = __n + this->size();
363
364      if (__len <= this->capacity())
365 {
366   if (__n)
367     this->_S_copy(this->_M_data() + this->size(), __s, __n);
368 }
369      else
370 this->_M_mutate(this->size(), size_type(0), __s, __n);
371
372      this->_M_set_length(__len);
373      return *this;
374    }
375
376  template<typename _CharT, typename _Traits, typename _Alloc>
377    template<typename _InputIterator>
378      basic_string<_CharT, _Traits, _Alloc>&
379      basic_string<_CharT, _Traits, _Alloc>::
380      _M_replace_dispatch(const_iterator __i1, const_iterator __i2,
381   _InputIterator __k1, _InputIterator __k2,
382   std::__false_type)
383      {
384 const basic_string __s(__k1, __k2);
385 const size_type __n1 = __i2 - __i1;
386 return _M_replace(__i1 - begin(), __n1, __s._M_data(),
387   __s.size());
388      }
389
390  template<typename _CharT, typename _Traits, typename _Alloc>
391    basic_string<_CharT, _Traits, _Alloc>&
392    basic_string<_CharT, _Traits, _Alloc>::
393    _M_replace_aux(size_type __pos1, size_type __n1, size_type __n2,
394    _CharT __c)
395    {
396      _M_check_length(__n1, __n2, "basic_string::_M_replace_aux");
397
398      const size_type __old_size = this->size();
399      const size_type __new_size = __old_size + __n2 - __n1;
400
401      if (__new_size <= this->capacity())
402 {
403   pointer __p = this->_M_data() + __pos1;
404
405   const size_type __how_much = __old_size - __pos1 - __n1;
406   if (__how_much && __n1 != __n2)
407     this->_S_move(__p + __n2, __p + __n1, __how_much);
408 }
409      else
410 this->_M_mutate(__pos1, __n1, 0, __n2);
411
412      if (__n2)
413 this->_S_assign(this->_M_data() + __pos1, __n2, __c);
414
415      this->_M_set_length(__new_size);
416      return *this;
417    }
418
419  template<typename _CharT, typename _Traits, typename _Alloc>
420    basic_string<_CharT, _Traits, _Alloc>&
421    basic_string<_CharT, _Traits, _Alloc>::
422    _M_replace(size_type __pos, size_type __len1, const _CharT* __s,
423        const size_type __len2)
424    {
425      _M_check_length(__len1, __len2, "basic_string::_M_replace");
426
427      const size_type __old_size = this->size();
428      const size_type __new_size = __old_size + __len2 - __len1;
429
430      if (__new_size <= this->capacity())
431 {
432   pointer __p = this->_M_data() + __pos;
433
434   const size_type __how_much = __old_size - __pos - __len1;
435   if (_M_disjunct(__s))
436     {
437       if (__how_much && __len1 != __len2)
438 this->_S_move(__p + __len2, __p + __len1, __how_much);
439       if (__len2)
440 this->_S_copy(__p, __s, __len2);
441     }
442   else
443     {
444       // Work in-place.
445       if (__len2 && __len2 <= __len1)
446 this->_S_move(__p, __s, __len2);
447       if (__how_much && __len1 != __len2)
448 this->_S_move(__p + __len2, __p + __len1, __how_much);
449       if (__len2 > __len1)
450 {
451   if (__s + __len2 <= __p + __len1)
452     this->_S_move(__p, __s, __len2);
453   else if (__s >= __p + __len1)
454     this->_S_copy(__p, __s + __len2 - __len1, __len2);
455   else
456     {
457       const size_type __nleft = (__p + __len1) - __s;
458       this->_S_move(__p, __s, __nleft);
459       this->_S_copy(__p + __nleft, __p + __len2,
460     __len2 - __nleft);
461     }
462 }
463     }
464 }
465      else
466 this->_M_mutate(__pos, __len1, __s, __len2);
467
468      this->_M_set_length(__new_size);
469      return *this;
470    }
471
472  template<typename _CharT, typename _Traits, typename _Alloc>
473    typename basic_string<_CharT, _Traits, _Alloc>::size_type
474    basic_string<_CharT, _Traits, _Alloc>::
475    copy(_CharT* __s, size_type __n, size_type __pos) const
476    {
477      _M_check(__pos, "basic_string::copy");
478      __n = _M_limit(__pos, __n);
479      __glibcxx_requires_string_len(__s, __n);
480      if (__n)
481 _S_copy(__s, _M_data() + __pos, __n);
482      // 21.3.5.7 par 3: do not append null.  (good.)
483      return __n;
484    }
485
486#else  // !_GLIBCXX_USE_CXX11_ABI
487
488  template<typename _CharT, typename _Traits, typename _Alloc>
489    const typename basic_string<_CharT, _Traits, _Alloc>::size_type
490    basic_string<_CharT, _Traits, _Alloc>::
491    _Rep::_S_max_size = (((npos - sizeof(_Rep_base))/sizeof(_CharT)) - 1) / 4;
492
493  template<typename _CharT, typename _Traits, typename _Alloc>
494    const _CharT
495    basic_string<_CharT, _Traits, _Alloc>::
496    _Rep::_S_terminal = _CharT();
497
498  template<typename _CharT, typename _Traits, typename _Alloc>
499    const typename basic_string<_CharT, _Traits, _Alloc>::size_type
500    basic_string<_CharT, _Traits, _Alloc>::npos;
501
502  // Linker sets _S_empty_rep_storage to all 0s (one reference, empty string)
503  // at static init time (before static ctors are run).
504  template<typename _CharT, typename _Traits, typename _Alloc>
505    typename basic_string<_CharT, _Traits, _Alloc>::size_type
506    basic_string<_CharT, _Traits, _Alloc>::_Rep::_S_empty_rep_storage[
507    (sizeof(_Rep_base) + sizeof(_CharT) + sizeof(size_type) - 1) /
508      sizeof(size_type)];
509
510  // NB: This is the special case for Input Iterators, used in
511  // istreambuf_iterators, etc.
512  // Input Iterators have a cost structure very different from
513  // pointers, calling for a different coding style.
514  template<typename _CharT, typename _Traits, typename _Alloc>
515    template<typename _InIterator>
516      _CharT*
517      basic_string<_CharT, _Traits, _Alloc>::
518      _S_construct(_InIterator __beg, _InIterator __end, const _Alloc& __a,
519    input_iterator_tag)
520      {
521#if _GLIBCXX_FULLY_DYNAMIC_STRING == 0
522 if (__beg == __end && __a == _Alloc())
523   return _S_empty_rep()._M_refdata();
524#endif
525 // Avoid reallocation for common case.
526 _CharT __buf[128];
527 size_type __len = 0;
528 while (__beg != __end && __len < sizeof(__buf) / sizeof(_CharT))
529   {
530     __buf[__len++] = *__beg;
531     ++__beg;
532   }
533 _Rep* __r = _Rep::_S_create(__len, size_type(0), __a);
534 _M_copy(__r->_M_refdata(), __buf, __len);
535 __try
536   {
537     while (__beg != __end)
538       {
539 if (__len == __r->_M_capacity)
540   {
541     // Allocate more space.
542     _Rep* __another = _Rep::_S_create(__len + 1, __len, __a);
543     _M_copy(__another->_M_refdata(), __r->_M_refdata(), __len);
544     __r->_M_destroy(__a);
545     __r = __another;
546   }
547 __r->_M_refdata()[__len++] = *__beg;
548 ++__beg;
549       }
550   }
551 __catch(...)
552   {
553     __r->_M_destroy(__a);
554     __throw_exception_again;
555   }
556 __r->_M_set_length_and_sharable(__len);
557 return __r->_M_refdata();
558      }
559
560  template<typename _CharT, typename _Traits, typename _Alloc>
561    template <typename _InIterator>
562      _CharT*
563      basic_string<_CharT, _Traits, _Alloc>::
564      _S_construct(_InIterator __beg, _InIterator __end, const _Alloc& __a,
565    forward_iterator_tag)
566      {
567#if _GLIBCXX_FULLY_DYNAMIC_STRING == 0
568 if (__beg == __end && __a == _Alloc())
569   return _S_empty_rep()._M_refdata();
570#endif
571 // NB: Not required, but considered best practice.
572 if (__gnu_cxx::__is_null_pointer(__beg) && __beg != __end)
573   __throw_logic_error(__N("basic_string::_S_construct null not valid"));
574
575 const size_type __dnew = static_cast<size_type>(std::distance(__beg,
576       __end));
577 // Check for out_of_range and length_error exceptions.
578 _Rep* __r = _Rep::_S_create(__dnew, size_type(0), __a);
579 __try
580   { _S_copy_chars(__r->_M_refdata(), __beg, __end); }
581 __catch(...)
582   {
583     __r->_M_destroy(__a);
584     __throw_exception_again;
585   }
586 __r->_M_set_length_and_sharable(__dnew);
587 return __r->_M_refdata();
588      }
589
590  template<typename _CharT, typename _Traits, typename _Alloc>
591    _CharT*
592    basic_string<_CharT, _Traits, _Alloc>::
593    _S_construct(size_type __n, _CharT __c, const _Alloc& __a)
594    {
595#if _GLIBCXX_FULLY_DYNAMIC_STRING == 0
596      if (__n == 0 && __a == _Alloc())
597 return _S_empty_rep()._M_refdata();
598#endif
599      // Check for out_of_range and length_error exceptions.
600      _Rep* __r = _Rep::_S_create(__n, size_type(0), __a);
601      if (__n)
602 _M_assign(__r->_M_refdata(), __n, __c);
603
604      __r->_M_set_length_and_sharable(__n);
605      return __r->_M_refdata();
606    }
607
608  template<typename _CharT, typename _Traits, typename _Alloc>
609    basic_string<_CharT, _Traits, _Alloc>::
610    basic_string(const basic_string& __str)
611    : _M_dataplus(__str._M_rep()->_M_grab(_Alloc(__str.get_allocator()),
612   __str.get_allocator()),
613   __str.get_allocator())
614    { }
615
616  template<typename _CharT, typename _Traits, typename _Alloc>
617    basic_string<_CharT, _Traits, _Alloc>::
618    basic_string(const _Alloc& __a)
619    : _M_dataplus(_S_construct(size_type(), _CharT(), __a), __a)
620    { }
621
622  template<typename _CharT, typename _Traits, typename _Alloc>
623    basic_string<_CharT, _Traits, _Alloc>::
624    basic_string(const basic_string& __str, size_type __pos, const _Alloc& __a)
625    : _M_dataplus(_S_construct(__str._M_data()
626        + __str._M_check(__pos,
627 "basic_string::basic_string"),
628        __str._M_data() + __str._M_limit(__pos, npos)
629        + __pos, __a), __a)
630    { }
631
632  template<typename _CharT, typename _Traits, typename _Alloc>
633    basic_string<_CharT, _Traits, _Alloc>::
634    basic_string(const basic_string& __str, size_type __pos, size_type __n)
635    : _M_dataplus(_S_construct(__str._M_data()
636        + __str._M_check(__pos,
637 "basic_string::basic_string"),
638        __str._M_data() + __str._M_limit(__pos, __n)
639        + __pos, _Alloc()), _Alloc())
640    { }
641
642  template<typename _CharT, typename _Traits, typename _Alloc>
643    basic_string<_CharT, _Traits, _Alloc>::
644    basic_string(const basic_string& __str, size_type __pos,
645  size_type __n, const _Alloc& __a)
646    : _M_dataplus(_S_construct(__str._M_data()
647        + __str._M_check(__pos,
648 "basic_string::basic_string"),
649        __str._M_data() + __str._M_limit(__pos, __n)
650        + __pos, __a), __a)
651    { }
652
653  // TBD: DPG annotate
654  template<typename _CharT, typename _Traits, typename _Alloc>
655    basic_string<_CharT, _Traits, _Alloc>::
656    basic_string(const _CharT* __s, size_type __n, const _Alloc& __a)
657    : _M_dataplus(_S_construct(__s, __s + __n, __a), __a)
658    { }
659
660  // TBD: DPG annotate
661  template<typename _CharT, typename _Traits, typename _Alloc>
662    basic_string<_CharT, _Traits, _Alloc>::
663    basic_string(const _CharT* __s, const _Alloc& __a)
664    : _M_dataplus(_S_construct(__s, __s ? __s + traits_type::length(__s) :
665        __s + npos, __a), __a)
666    { }
667
668  template<typename _CharT, typename _Traits, typename _Alloc>
669    basic_string<_CharT, _Traits, _Alloc>::
670    basic_string(size_type __n, _CharT __c, const _Alloc& __a)
671    : _M_dataplus(_S_construct(__n, __c, __a), __a)
672    { }
673
674  // TBD: DPG annotate
675  template<typename _CharT, typename _Traits, typename _Alloc>
676    template<typename _InputIterator>
677    basic_string<_CharT, _Traits, _Alloc>::
678    basic_string(_InputIterator __beg, _InputIterator __end, const _Alloc& __a)
679    : _M_dataplus(_S_construct(__beg, __end, __a), __a)
680    { }
681
682#if __cplusplus >= 201103L
683  template<typename _CharT, typename _Traits, typename _Alloc>
684    basic_string<_CharT, _Traits, _Alloc>::
685    basic_string(initializer_list<_CharT> __l, const _Alloc& __a)
686    : _M_dataplus(_S_construct(__l.begin(), __l.end(), __a), __a)
687    { }
688#endif
689
690  template<typename _CharT, typename _Traits, typename _Alloc>
691    basic_string<_CharT, _Traits, _Alloc>&
692    basic_string<_CharT, _Traits, _Alloc>::
693    assign(const basic_string& __str)
694    {
695      if (_M_rep() != __str._M_rep())
696 {
697   // XXX MT
698   const allocator_type __a = this->get_allocator();
699   _CharT* __tmp = __str._M_rep()->_M_grab(__a, __str.get_allocator());
700   _M_rep()->_M_dispose(__a);
701   _M_data(__tmp);
702 }
703      return *this;
704    }
705
706  template<typename _CharT, typename _Traits, typename _Alloc>
707    basic_string<_CharT, _Traits, _Alloc>&
708    basic_string<_CharT, _Traits, _Alloc>::
709    assign(const _CharT* __s, size_type __n)
710    {
711      __glibcxx_requires_string_len(__s, __n);
712      _M_check_length(this->size(), __n, "basic_string::assign");
713      if (_M_disjunct(__s) || _M_rep()->_M_is_shared())
714 return _M_replace_safe(size_type(0), this->size(), __s, __n);
715      else
716 {
717   // Work in-place.
718   const size_type __pos = __s - _M_data();
719   if (__pos >= __n)
720     _M_copy(_M_data(), __s, __n);
721   else if (__pos)
722     _M_move(_M_data(), __s, __n);
723   _M_rep()->_M_set_length_and_sharable(__n);
724   return *this;
725 }
726     }
727
728  template<typename _CharT, typename _Traits, typename _Alloc>
729    basic_string<_CharT, _Traits, _Alloc>&
730    basic_string<_CharT, _Traits, _Alloc>::
731    append(size_type __n, _CharT __c)
732    {
733      if (__n)
734 {
735   _M_check_length(size_type(0), __n, "basic_string::append");   
736   const size_type __len = __n + this->size();
737   if (__len > this->capacity() || _M_rep()->_M_is_shared())
738     this->reserve(__len);
739   _M_assign(_M_data() + this->size(), __n, __c);
740   _M_rep()->_M_set_length_and_sharable(__len);
741 }
742      return *this;
743    }
744
745  template<typename _CharT, typename _Traits, typename _Alloc>
746    basic_string<_CharT, _Traits, _Alloc>&
747    basic_string<_CharT, _Traits, _Alloc>::
748    append(const _CharT* __s, size_type __n)
749    {
750      __glibcxx_requires_string_len(__s, __n);
751      if (__n)
752 {
753   _M_check_length(size_type(0), __n, "basic_string::append");
754   const size_type __len = __n + this->size();
755   if (__len > this->capacity() || _M_rep()->_M_is_shared())
756     {
757       if (_M_disjunct(__s))
758 this->reserve(__len);
759       else
760 {
761   const size_type __off = __s - _M_data();
762   this->reserve(__len);
763   __s = _M_data() + __off;
764 }
765     }
766   _M_copy(_M_data() + this->size(), __s, __n);
767   _M_rep()->_M_set_length_and_sharable(__len);
768 }
769      return *this;
770    }
771
772  template<typename _CharT, typename _Traits, typename _Alloc>
773    basic_string<_CharT, _Traits, _Alloc>&
774    basic_string<_CharT, _Traits, _Alloc>::
775    append(const basic_string& __str)
776    {
777      const size_type __size = __str.size();
778      if (__size)
779 {
780   const size_type __len = __size + this->size();
781   if (__len > this->capacity() || _M_rep()->_M_is_shared())
782     this->reserve(__len);
783   _M_copy(_M_data() + this->size(), __str._M_data(), __size);
784   _M_rep()->_M_set_length_and_sharable(__len);
785 }
786      return *this;
787    }    
788
789  template<typename _CharT, typename _Traits, typename _Alloc>
790    basic_string<_CharT, _Traits, _Alloc>&
791    basic_string<_CharT, _Traits, _Alloc>::
792    append(const basic_string& __str, size_type __pos, size_type __n)
793    {
794      __str._M_check(__pos, "basic_string::append");
795      __n = __str._M_limit(__pos, __n);
796      if (__n)
797 {
798   const size_type __len = __n + this->size();
799   if (__len > this->capacity() || _M_rep()->_M_is_shared())
800     this->reserve(__len);
801   _M_copy(_M_data() + this->size(), __str._M_data() + __pos, __n);
802   _M_rep()->_M_set_length_and_sharable(__len);   
803 }
804      return *this;
805    }
806
807   template<typename _CharT, typename _Traits, typename _Alloc>
808     basic_string<_CharT, _Traits, _Alloc>&
809     basic_string<_CharT, _Traits, _Alloc>::
810     insert(size_type __pos, const _CharT* __s, size_type __n)
811     {
812       __glibcxx_requires_string_len(__s, __n);
813       _M_check(__pos, "basic_string::insert");
814       _M_check_length(size_type(0), __n, "basic_string::insert");
815       if (_M_disjunct(__s) || _M_rep()->_M_is_shared())
816         return _M_replace_safe(__pos, size_type(0), __s, __n);
817       else
818         {
819           // Work in-place.
820           const size_type __off = __s - _M_data();
821           _M_mutate(__pos, 0, __n);
822           __s = _M_data() + __off;
823           _CharT* __p = _M_data() + __pos;
824           if (__s  + __n <= __p)
825             _M_copy(__p, __s, __n);
826           else if (__s >= __p)
827             _M_copy(__p, __s + __n, __n);
828           else
829             {
830        const size_type __nleft = __p - __s;
831               _M_copy(__p, __s, __nleft);
832               _M_copy(__p + __nleft, __p + __n, __n - __nleft);
833             }
834           return *this;
835         }
836     }
837
838   template<typename _CharT, typename _Traits, typename _Alloc>
839     typename basic_string<_CharT, _Traits, _Alloc>::iterator
840     basic_string<_CharT, _Traits, _Alloc>::
841     erase(iterator __first, iterator __last)
842     {
843       _GLIBCXX_DEBUG_PEDASSERT(__first >= _M_ibegin() && __first <= __last
844 && __last <= _M_iend());
845
846       // NB: This isn't just an optimization (bail out early when
847       // there is nothing to do, really), it's also a correctness
848       // issue vs MT, see libstdc++/40518.
849       const size_type __size = __last - __first;
850       if (__size)
851  {
852    const size_type __pos = __first - _M_ibegin();
853    _M_mutate(__pos, __size, size_type(0));
854    _M_rep()->_M_set_leaked();
855    return iterator(_M_data() + __pos);
856  }
857       else
858  return __first;
859     }
860
861   template<typename _CharT, typename _Traits, typename _Alloc>
862     basic_string<_CharT, _Traits, _Alloc>&
863     basic_string<_CharT, _Traits, _Alloc>::
864     replace(size_type __pos, size_type __n1, const _CharT* __s,
865      size_type __n2)
866     {
867       __glibcxx_requires_string_len(__s, __n2);
868       _M_check(__pos, "basic_string::replace");
869       __n1 = _M_limit(__pos, __n1);
870       _M_check_length(__n1, __n2, "basic_string::replace");
871       bool __left;
872       if (_M_disjunct(__s) || _M_rep()->_M_is_shared())
873         return _M_replace_safe(__pos, __n1, __s, __n2);
874       else if ((__left = __s + __n2 <= _M_data() + __pos)
875 || _M_data() + __pos + __n1 <= __s)
876  {
877    // Work in-place: non-overlapping case.
878    size_type __off = __s - _M_data();
879    __left ? __off : (__off += __n2 - __n1);
880    _M_mutate(__pos, __n1, __n2);
881    _M_copy(_M_data() + __pos, _M_data() + __off, __n2);
882    return *this;
883  }
884       else
885  {
886    // Todo: overlapping case.
887    const basic_string __tmp(__s, __n2);
888    return _M_replace_safe(__pos, __n1, __tmp._M_data(), __n2);
889  }
890     }
891
892  template<typename _CharT, typename _Traits, typename _Alloc>
893    void
894    basic_string<_CharT, _Traits, _Alloc>::_Rep::
895    _M_destroy(const _Alloc& __a) throw ()
896    {
897      const size_type __size = sizeof(_Rep_base) +
898                        (this->_M_capacity + 1) * sizeof(_CharT);
899      _Raw_bytes_alloc(__a).deallocate(reinterpret_cast<char*>(this), __size);
900    }
901
902  template<typename _CharT, typename _Traits, typename _Alloc>
903    void
904    basic_string<_CharT, _Traits, _Alloc>::
905    _M_leak_hard()
906    {
907#if _GLIBCXX_FULLY_DYNAMIC_STRING == 0
908      if (_M_rep() == &_S_empty_rep())
909 return;
910#endif
911      if (_M_rep()->_M_is_shared())
912 _M_mutate(0, 0, 0);
913      _M_rep()->_M_set_leaked();
914    }
915
916  template<typename _CharT, typename _Traits, typename _Alloc>
917    void
918    basic_string<_CharT, _Traits, _Alloc>::
919    _M_mutate(size_type __pos, size_type __len1, size_type __len2)
920    {
921      const size_type __old_size = this->size();
922      const size_type __new_size = __old_size + __len2 - __len1;
923      const size_type __how_much = __old_size - __pos - __len1;
924
925      if (__new_size > this->capacity() || _M_rep()->_M_is_shared())
926 {
927   // Must reallocate.
928   const allocator_type __a = get_allocator();
929   _Rep* __r = _Rep::_S_create(__new_size, this->capacity(), __a);
930
931   if (__pos)
932     _M_copy(__r->_M_refdata(), _M_data(), __pos);
933   if (__how_much)
934     _M_copy(__r->_M_refdata() + __pos + __len2,
935     _M_data() + __pos + __len1, __how_much);
936
937   _M_rep()->_M_dispose(__a);
938   _M_data(__r->_M_refdata());
939 }
940      else if (__how_much && __len1 != __len2)
941 {
942   // Work in-place.
943   _M_move(_M_data() + __pos + __len2,
944   _M_data() + __pos + __len1, __how_much);
945 }
946      _M_rep()->_M_set_length_and_sharable(__new_size);
947    }
948
949  template<typename _CharT, typename _Traits, typename _Alloc>
950    void
951    basic_string<_CharT, _Traits, _Alloc>::
952    reserve(size_type __res)
953    {
954      if (__res != this->capacity() || _M_rep()->_M_is_shared())
955        {
956   // Make sure we don't shrink below the current size
957   if (__res < this->size())
958     __res = this->size();
959   const allocator_type __a = get_allocator();
960   _CharT* __tmp = _M_rep()->_M_clone(__a, __res - this->size());
961   _M_rep()->_M_dispose(__a);
962   _M_data(__tmp);
963        }
964    }
965
966  template<typename _CharT, typename _Traits, typename _Alloc>
967    void
968    basic_string<_CharT, _Traits, _Alloc>::
969    swap(basic_string& __s)
970    {
971      if (_M_rep()->_M_is_leaked())
972 _M_rep()->_M_set_sharable();
973      if (__s._M_rep()->_M_is_leaked())
974 __s._M_rep()->_M_set_sharable();
975      if (this->get_allocator() == __s.get_allocator())
976 {
977   _CharT* __tmp = _M_data();
978   _M_data(__s._M_data());
979   __s._M_data(__tmp);
980 }
981      // The code below can usually be optimized away.
982      else
983 {
984   const basic_string __tmp1(_M_ibegin(), _M_iend(),
985     __s.get_allocator());
986   const basic_string __tmp2(__s._M_ibegin(), __s._M_iend(),
987     this->get_allocator());
988   *this = __tmp2;
989   __s = __tmp1;
990 }
991    }
992
993  template<typename _CharT, typename _Traits, typename _Alloc>
994    typename basic_string<_CharT, _Traits, _Alloc>::_Rep*
995    basic_string<_CharT, _Traits, _Alloc>::_Rep::
996    _S_create(size_type __capacity, size_type __old_capacity,
997       const _Alloc& __alloc)
998    {
999      // _GLIBCXX_RESOLVE_LIB_DEFECTS
1000      // 83.  String::npos vs. string::max_size()
1001      if (__capacity > _S_max_size)
1002 __throw_length_error(__N("basic_string::_S_create"));
1003
1004      // The standard places no restriction on allocating more memory
1005      // than is strictly needed within this layer at the moment or as
1006      // requested by an explicit application call to reserve().
1007
1008      // Many malloc implementations perform quite poorly when an
1009      // application attempts to allocate memory in a stepwise fashion
1010      // growing each allocation size by only 1 char.  Additionally,
1011      // it makes little sense to allocate less linear memory than the
1012      // natural blocking size of the malloc implementation.
1013      // Unfortunately, we would need a somewhat low-level calculation
1014      // with tuned parameters to get this perfect for any particular
1015      // malloc implementation.  Fortunately, generalizations about
1016      // common features seen among implementations seems to suffice.
1017
1018      // __pagesize need not match the actual VM page size for good
1019      // results in practice, thus we pick a common value on the low
1020      // side.  __malloc_header_size is an estimate of the amount of
1021      // overhead per memory allocation (in practice seen N * sizeof
1022      // (void*) where N is 0, 2 or 4).  According to folklore,
1023      // picking this value on the high side is better than
1024      // low-balling it (especially when this algorithm is used with
1025      // malloc implementations that allocate memory blocks rounded up
1026      // to a size which is a power of 2).
1027      const size_type __pagesize = 4096;
1028      const size_type __malloc_header_size = 4 * sizeof(void*);
1029
1030      // The below implements an exponential growth policy, necessary to
1031      // meet amortized linear time requirements of the library: see
1032      // http://gcc.gnu.org/ml/libstdc++/2001-07/msg00085.html.
1033      // It's active for allocations requiring an amount of memory above
1034      // system pagesize. This is consistent with the requirements of the
1035      // standard: http://gcc.gnu.org/ml/libstdc++/2001-07/msg00130.html
1036      if (__capacity > __old_capacity && __capacity < 2 * __old_capacity)
1037 __capacity = 2 * __old_capacity;
1038
1039      // NB: Need an array of char_type[__capacity], plus a terminating
1040      // null char_type() element, plus enough for the _Rep data structure.
1041      // Whew. Seemingly so needy, yet so elemental.
1042      size_type __size = (__capacity + 1) * sizeof(_CharT) + sizeof(_Rep);
1043
1044      const size_type __adj_size = __size + __malloc_header_size;
1045      if (__adj_size > __pagesize && __capacity > __old_capacity)
1046 {
1047   const size_type __extra = __pagesize - __adj_size % __pagesize;
1048   __capacity += __extra / sizeof(_CharT);
1049   // Never allocate a string bigger than _S_max_size.
1050   if (__capacity > _S_max_size)
1051     __capacity = _S_max_size;
1052   __size = (__capacity + 1) * sizeof(_CharT) + sizeof(_Rep);
1053 }
1054
1055      // NB: Might throw, but no worries about a leak, mate: _Rep()
1056      // does not throw.
1057      void* __place = _Raw_bytes_alloc(__alloc).allocate(__size);
1058      _Rep *__p = new (__place) _Rep;
1059      __p->_M_capacity = __capacity;
1060      // ABI compatibility - 3.4.x set in _S_create both
1061      // _M_refcount and _M_length.  All callers of _S_create
1062      // in basic_string.tcc then set just _M_length.
1063      // In 4.0.x and later both _M_refcount and _M_length
1064      // are initialized in the callers, unfortunately we can
1065      // have 3.4.x compiled code with _S_create callers inlined
1066      // calling 4.0.x+ _S_create.
1067      __p->_M_set_sharable();
1068      return __p;
1069    }
1070
1071  template<typename _CharT, typename _Traits, typename _Alloc>
1072    _CharT*
1073    basic_string<_CharT, _Traits, _Alloc>::_Rep::
1074    _M_clone(const _Alloc& __alloc, size_type __res)
1075    {
1076      // Requested capacity of the clone.
1077      const size_type __requested_cap = this->_M_length + __res;
1078      _Rep* __r = _Rep::_S_create(__requested_cap, this->_M_capacity,
1079   __alloc);
1080      if (this->_M_length)
1081 _M_copy(__r->_M_refdata(), _M_refdata(), this->_M_length);
1082
1083      __r->_M_set_length_and_sharable(this->_M_length);
1084      return __r->_M_refdata();
1085    }
1086
1087  template<typename _CharT, typename _Traits, typename _Alloc>
1088    void
1089    basic_string<_CharT, _Traits, _Alloc>::
1090    resize(size_type __n, _CharT __c)
1091    {
1092      const size_type __size = this->size();
1093      _M_check_length(__size, __n, "basic_string::resize");
1094      if (__size < __n)
1095 this->append(__n - __size, __c);
1096      else if (__n < __size)
1097 this->erase(__n);
1098      // else nothing (in particular, avoid calling _M_mutate() unnecessarily.)
1099    }
1100
1101  template<typename _CharT, typename _Traits, typename _Alloc>
1102    template<typename _InputIterator>
1103      basic_string<_CharT, _Traits, _Alloc>&
1104      basic_string<_CharT, _Traits, _Alloc>::
1105      _M_replace_dispatch(iterator __i1, iterator __i2, _InputIterator __k1,
1106   _InputIterator __k2, __false_type)
1107      {
1108 const basic_string __s(__k1, __k2);
1109 const size_type __n1 = __i2 - __i1;
1110 _M_check_length(__n1, __s.size(), "basic_string::_M_replace_dispatch");
1111 return _M_replace_safe(__i1 - _M_ibegin(), __n1, __s._M_data(),
1112        __s.size());
1113      }
1114
1115  template<typename _CharT, typename _Traits, typename _Alloc>
1116    basic_string<_CharT, _Traits, _Alloc>&
1117    basic_string<_CharT, _Traits, _Alloc>::
1118    _M_replace_aux(size_type __pos1, size_type __n1, size_type __n2,
1119    _CharT __c)
1120    {
1121      _M_check_length(__n1, __n2, "basic_string::_M_replace_aux");
1122      _M_mutate(__pos1, __n1, __n2);
1123      if (__n2)
1124 _M_assign(_M_data() + __pos1, __n2, __c);
1125      return *this;
1126    }
1127
1128  template<typename _CharT, typename _Traits, typename _Alloc>
1129    basic_string<_CharT, _Traits, _Alloc>&
1130    basic_string<_CharT, _Traits, _Alloc>::
1131    _M_replace_safe(size_type __pos1, size_type __n1, const _CharT* __s,
1132     size_type __n2)
1133    {
1134      _M_mutate(__pos1, __n1, __n2);
1135      if (__n2)
1136 _M_copy(_M_data() + __pos1, __s, __n2);
1137      return *this;
1138    }
1139
1140    template<typename _CharT, typename _Traits, typename _Alloc>
1141    typename basic_string<_CharT, _Traits, _Alloc>::size_type
1142    basic_string<_CharT, _Traits, _Alloc>::
1143    copy(_CharT* __s, size_type __n, size_type __pos) const
1144    {
1145      _M_check(__pos, "basic_string::copy");
1146      __n = _M_limit(__pos, __n);
1147      __glibcxx_requires_string_len(__s, __n);
1148      if (__n)
1149 _M_copy(__s, _M_data() + __pos, __n);
1150      // 21.3.5.7 par 3: do not append null.  (good.)
1151      return __n;
1152    }
1153#endif  // !_GLIBCXX_USE_CXX11_ABI
1154   
1155  template<typename _CharT, typename _Traits, typename _Alloc>
1156    basic_string<_CharT, _Traits, _Alloc>
1157    operator+(const _CharT* __lhs,
1158       const basic_string<_CharT, _Traits, _Alloc>& __rhs)
1159    {
1160      __glibcxx_requires_string(__lhs);
1161      typedef basic_string<_CharT, _Traits, _Alloc> __string_type;
1162      typedef typename __string_type::size_type   __size_type;
1163      const __size_type __len = _Traits::length(__lhs);
1164      __string_type __str;
1165      __str.reserve(__len + __rhs.size());
1166      __str.append(__lhs, __len);
1167      __str.append(__rhs);
1168      return __str;
1169    }
1170
1171  template<typename _CharT, typename _Traits, typename _Alloc>
1172    basic_string<_CharT, _Traits, _Alloc>
1173    operator+(_CharT __lhs, const basic_string<_CharT, _Traits, _Alloc>& __rhs)
1174    {
1175      typedef basic_string<_CharT, _Traits, _Alloc> __string_type;
1176      typedef typename __string_type::size_type   __size_type;
1177      __string_type __str;
1178      const __size_type __len = __rhs.size();
1179      __str.reserve(__len + 1);
1180      __str.append(__size_type(1), __lhs);
1181      __str.append(__rhs);
1182      return __str;
1183    }
1184
1185  template<typename _CharT, typename _Traits, typename _Alloc>
1186    typename basic_string<_CharT, _Traits, _Alloc>::size_type
1187    basic_string<_CharT, _Traits, _Alloc>::
1188    find(const _CharT* __s, size_type __pos, size_type __n) const
1189    _GLIBCXX_NOEXCEPT
1190    {
1191      __glibcxx_requires_string_len(__s, __n);
1192      const size_type __size = this->size();
1193
1194      if (__n == 0)
1195 return __pos <= __size ? __pos : npos;
1196      if (__pos >= __size)
1197 return npos;
1198
1199      const _CharT __elem0 = __s[0];
1200      const _CharT* const __data = data();
1201      const _CharT* __first = __data + __pos;
1202      const _CharT* const __last = __data + __size;
1203      size_type __len = __size - __pos;
1204
1205      while (__len >= __n)
1206 {
1207   // Find the first occurrence of __elem0:
1208   __first = traits_type::find(__first, __len - __n + 1, __elem0);
1209   if (!__first)
1210     return npos;
1211   // Compare the full strings from the first occurrence of __elem0.
1212   // We already know that __first[0] == __s[0] but compare them again
1213   // anyway because __s is probably aligned, which helps memcmp.
1214   if (traits_type::compare(__first, __s, __n) == 0)
1215     return __first - __data;
1216   __len = __last - ++__first;
1217 }
1218      return npos;
1219    }
1220
1221  template<typename _CharT, typename _Traits, typename _Alloc>
1222    typename basic_string<_CharT, _Traits, _Alloc>::size_type
1223    basic_string<_CharT, _Traits, _Alloc>::
1224    find(_CharT __c, size_type __pos) const _GLIBCXX_NOEXCEPT
1225    {
1226      size_type __ret = npos;
1227      const size_type __size = this->size();
1228      if (__pos < __size)
1229 {
1230   const _CharT* __data = _M_data();
1231   const size_type __n = __size - __pos;
1232   const _CharT* __p = traits_type::find(__data + __pos, __n, __c);
1233   if (__p)
1234     __ret = __p - __data;
1235 }
1236      return __ret;
1237    }
1238
1239  template<typename _CharT, typename _Traits, typename _Alloc>
1240    typename basic_string<_CharT, _Traits, _Alloc>::size_type
1241    basic_string<_CharT, _Traits, _Alloc>::
1242    rfind(const _CharT* __s, size_type __pos, size_type __n) const
1243    _GLIBCXX_NOEXCEPT
1244    {
1245      __glibcxx_requires_string_len(__s, __n);
1246      const size_type __size = this->size();
1247      if (__n <= __size)
1248 {
1249   __pos = std::min(size_type(__size - __n), __pos);
1250   const _CharT* __data = _M_data();
1251   do
1252     {
1253       if (traits_type::compare(__data + __pos, __s, __n) == 0)
1254 return __pos;
1255     }
1256   while (__pos-- > 0);
1257 }
1258      return npos;
1259    }
1260
1261  template<typename _CharT, typename _Traits, typename _Alloc>
1262    typename basic_string<_CharT, _Traits, _Alloc>::size_type
1263    basic_string<_CharT, _Traits, _Alloc>::
1264    rfind(_CharT __c, size_type __pos) const _GLIBCXX_NOEXCEPT
1265    {
1266      size_type __size = this->size();
1267      if (__size)
1268 {
1269   if (--__size > __pos)
1270     __size = __pos;
1271   for (++__size; __size-- > 0; )
1272     if (traits_type::eq(_M_data()[__size], __c))
1273       return __size;
1274 }
1275      return npos;
1276    }
1277
1278  template<typename _CharT, typename _Traits, typename _Alloc>
1279    typename basic_string<_CharT, _Traits, _Alloc>::size_type
1280    basic_string<_CharT, _Traits, _Alloc>::
1281    find_first_of(const _CharT* __s, size_type __pos, size_type __n) const
1282    _GLIBCXX_NOEXCEPT
1283    {
1284      __glibcxx_requires_string_len(__s, __n);
1285      for (; __n && __pos < this->size(); ++__pos)
1286 {
1287   const _CharT* __p = traits_type::find(__s, __n, _M_data()[__pos]);
1288   if (__p)
1289     return __pos;
1290 }
1291      return npos;
1292    }
1293
1294  template<typename _CharT, typename _Traits, typename _Alloc>
1295    typename basic_string<_CharT, _Traits, _Alloc>::size_type
1296    basic_string<_CharT, _Traits, _Alloc>::
1297    find_last_of(const _CharT* __s, size_type __pos, size_type __n) const
1298    _GLIBCXX_NOEXCEPT
1299    {
1300      __glibcxx_requires_string_len(__s, __n);
1301      size_type __size = this->size();
1302      if (__size && __n)
1303 {
1304   if (--__size > __pos)
1305     __size = __pos;
1306   do
1307     {
1308       if (traits_type::find(__s, __n, _M_data()[__size]))
1309 return __size;
1310     }
1311   while (__size-- != 0);
1312 }
1313      return npos;
1314    }
1315
1316  template<typename _CharT, typename _Traits, typename _Alloc>
1317    typename basic_string<_CharT, _Traits, _Alloc>::size_type
1318    basic_string<_CharT, _Traits, _Alloc>::
1319    find_first_not_of(const _CharT* __s, size_type __pos, size_type __n) const
1320    _GLIBCXX_NOEXCEPT
1321    {
1322      __glibcxx_requires_string_len(__s, __n);
1323      for (; __pos < this->size(); ++__pos)
1324 if (!traits_type::find(__s, __n, _M_data()[__pos]))
1325   return __pos;
1326      return npos;
1327    }
1328
1329  template<typename _CharT, typename _Traits, typename _Alloc>
1330    typename basic_string<_CharT, _Traits, _Alloc>::size_type
1331    basic_string<_CharT, _Traits, _Alloc>::
1332    find_first_not_of(_CharT __c, size_type __pos) const _GLIBCXX_NOEXCEPT
1333    {
1334      for (; __pos < this->size(); ++__pos)
1335 if (!traits_type::eq(_M_data()[__pos], __c))
1336   return __pos;
1337      return npos;
1338    }
1339
1340  template<typename _CharT, typename _Traits, typename _Alloc>
1341    typename basic_string<_CharT, _Traits, _Alloc>::size_type
1342    basic_string<_CharT, _Traits, _Alloc>::
1343    find_last_not_of(const _CharT* __s, size_type __pos, size_type __n) const
1344    _GLIBCXX_NOEXCEPT
1345    {
1346      __glibcxx_requires_string_len(__s, __n);
1347      size_type __size = this->size();
1348      if (__size)
1349 {
1350   if (--__size > __pos)
1351     __size = __pos;
1352   do
1353     {
1354       if (!traits_type::find(__s, __n, _M_data()[__size]))
1355 return __size;
1356     }
1357   while (__size--);
1358 }
1359      return npos;
1360    }
1361
1362  template<typename _CharT, typename _Traits, typename _Alloc>
1363    typename basic_string<_CharT, _Traits, _Alloc>::size_type
1364    basic_string<_CharT, _Traits, _Alloc>::
1365    find_last_not_of(_CharT __c, size_type __pos) const _GLIBCXX_NOEXCEPT
1366    {
1367      size_type __size = this->size();
1368      if (__size)
1369 {
1370   if (--__size > __pos)
1371     __size = __pos;
1372   do
1373     {
1374       if (!traits_type::eq(_M_data()[__size], __c))
1375 return __size;
1376     }
1377   while (__size--);
1378 }
1379      return npos;
1380    }
1381
1382  template<typename _CharT, typename _Traits, typename _Alloc>
1383    int
1384    basic_string<_CharT, _Traits, _Alloc>::
1385    compare(size_type __pos, size_type __n, const basic_string& __str) const
1386    {
1387      _M_check(__pos, "basic_string::compare");
1388      __n = _M_limit(__pos, __n);
1389      const size_type __osize = __str.size();
1390      const size_type __len = std::min(__n, __osize);
1391      int __r = traits_type::compare(_M_data() + __pos, __str.data(), __len);
1392      if (!__r)
1393 __r = _S_compare(__n, __osize);
1394      return __r;
1395    }
1396
1397  template<typename _CharT, typename _Traits, typename _Alloc>
1398    int
1399    basic_string<_CharT, _Traits, _Alloc>::
1400    compare(size_type __pos1, size_type __n1, const basic_string& __str,
1401     size_type __pos2, size_type __n2) const
1402    {
1403      _M_check(__pos1, "basic_string::compare");
1404      __str._M_check(__pos2, "basic_string::compare");
1405      __n1 = _M_limit(__pos1, __n1);
1406      __n2 = __str._M_limit(__pos2, __n2);
1407      const size_type __len = std::min(__n1, __n2);
1408      int __r = traits_type::compare(_M_data() + __pos1,
1409      __str.data() + __pos2, __len);
1410      if (!__r)
1411 __r = _S_compare(__n1, __n2);
1412      return __r;
1413    }
1414
1415  template<typename _CharT, typename _Traits, typename _Alloc>
1416    int
1417    basic_string<_CharT, _Traits, _Alloc>::
1418    compare(const _CharT* __s) const _GLIBCXX_NOEXCEPT
1419    {
1420      __glibcxx_requires_string(__s);
1421      const size_type __size = this->size();
1422      const size_type __osize = traits_type::length(__s);
1423      const size_type __len = std::min(__size, __osize);
1424      int __r = traits_type::compare(_M_data(), __s, __len);
1425      if (!__r)
1426 __r = _S_compare(__size, __osize);
1427      return __r;
1428    }
1429
1430  template<typename _CharT, typename _Traits, typename _Alloc>
1431    int
1432    basic_string <_CharT, _Traits, _Alloc>::
1433    compare(size_type __pos, size_type __n1, const _CharT* __s) const
1434    {
1435      __glibcxx_requires_string(__s);
1436      _M_check(__pos, "basic_string::compare");
1437      __n1 = _M_limit(__pos, __n1);
1438      const size_type __osize = traits_type::length(__s);
1439      const size_type __len = std::min(__n1, __osize);
1440      int __r = traits_type::compare(_M_data() + __pos, __s, __len);
1441      if (!__r)
1442 __r = _S_compare(__n1, __osize);
1443      return __r;
1444    }
1445
1446  template<typename _CharT, typename _Traits, typename _Alloc>
1447    int
1448    basic_string <_CharT, _Traits, _Alloc>::
1449    compare(size_type __pos, size_type __n1, const _CharT* __s,
1450     size_type __n2) const
1451    {
1452      __glibcxx_requires_string_len(__s, __n2);
1453      _M_check(__pos, "basic_string::compare");
1454      __n1 = _M_limit(__pos, __n1);
1455      const size_type __len = std::min(__n1, __n2);
1456      int __r = traits_type::compare(_M_data() + __pos, __s, __len);
1457      if (!__r)
1458 __r = _S_compare(__n1, __n2);
1459      return __r;
1460    }
1461
1462  // 21.3.7.9 basic_string::getline and operators
1463  template<typename _CharT, typename _Traits, typename _Alloc>
1464    basic_istream<_CharT, _Traits>&
1465    operator>>(basic_istream<_CharT, _Traits>& __in,
1466        basic_string<_CharT, _Traits, _Alloc>& __str)
1467    {
1468      typedef basic_istream<_CharT, _Traits> __istream_type;
1469      typedef basic_string<_CharT, _Traits, _Alloc> __string_type;
1470      typedef typename __istream_type::ios_base         __ios_base;
1471      typedef typename __istream_type::int_type __int_type;
1472      typedef typename __string_type::size_type __size_type;
1473      typedef ctype<_CharT> __ctype_type;
1474      typedef typename __ctype_type::ctype_base         __ctype_base;
1475
1476      __size_type __extracted = 0;
1477      typename __ios_base::iostate __err = __ios_base::goodbit;
1478      typename __istream_type::sentry __cerb(__in, false);
1479      if (__cerb)
1480 {
1481   __try
1482     {
1483       // Avoid reallocation for common case.
1484       __str.erase();
1485       _CharT __buf[128];
1486       __size_type __len = 0;       
1487       const streamsize __w = __in.width();
1488       const __size_type __n = __w > 0 ? static_cast<__size_type>(__w)
1489                               : __str.max_size();
1490       const __ctype_type& __ct = use_facet<__ctype_type>(__in.getloc());
1491       const __int_type __eof = _Traits::eof();
1492       __int_type __c = __in.rdbuf()->sgetc();
1493
1494       while (__extracted < __n
1495      && !_Traits::eq_int_type(__c, __eof)
1496      && !__ct.is(__ctype_base::space,
1497  _Traits::to_char_type(__c)))
1498 {
1499   if (__len == sizeof(__buf) / sizeof(_CharT))
1500     {
1501       __str.append(__buf, sizeof(__buf) / sizeof(_CharT));
1502       __len = 0;
1503     }
1504   __buf[__len++] = _Traits::to_char_type(__c);
1505   ++__extracted;
1506   __c = __in.rdbuf()->snextc();
1507 }
1508       __str.append(__buf, __len);
1509
1510       if (_Traits::eq_int_type(__c, __eof))
1511 __err |= __ios_base::eofbit;
1512       __in.width(0);
1513     }
1514   __catch(__cxxabiv1::__forced_unwind&)
1515     {
1516       __in._M_setstate(__ios_base::badbit);
1517       __throw_exception_again;
1518     }
1519   __catch(...)
1520     {
1521       // _GLIBCXX_RESOLVE_LIB_DEFECTS
1522       // 91. Description of operator>> and getline() for string<>
1523       // might cause endless loop
1524       __in._M_setstate(__ios_base::badbit);
1525     }
1526 }
1527      // 211.  operator>>(istream&, string&) doesn't set failbit
1528      if (!__extracted)
1529 __err |= __ios_base::failbit;
1530      if (__err)
1531 __in.setstate(__err);
1532      return __in;
1533    }
1534
1535  template<typename _CharT, typename _Traits, typename _Alloc>
1536    basic_istream<_CharT, _Traits>&
1537    getline(basic_istream<_CharT, _Traits>& __in,
1538     basic_string<_CharT, _Traits, _Alloc>& __str, _CharT __delim)
1539    {
1540      typedef basic_istream<_CharT, _Traits> __istream_type;
1541      typedef basic_string<_CharT, _Traits, _Alloc> __string_type;
1542      typedef typename __istream_type::ios_base         __ios_base;
1543      typedef typename __istream_type::int_type __int_type;
1544      typedef typename __string_type::size_type __size_type;
1545
1546      __size_type __extracted = 0;
1547      const __size_type __n = __str.max_size();
1548      typename __ios_base::iostate __err = __ios_base::goodbit;
1549      typename __istream_type::sentry __cerb(__in, true);
1550      if (__cerb)
1551 {
1552   __try
1553     {
1554       __str.erase();
1555       const __int_type __idelim = _Traits::to_int_type(__delim);
1556       const __int_type __eof = _Traits::eof();
1557       __int_type __c = __in.rdbuf()->sgetc();
1558
1559       while (__extracted < __n
1560      && !_Traits::eq_int_type(__c, __eof)
1561      && !_Traits::eq_int_type(__c, __idelim))
1562 {
1563   __str += _Traits::to_char_type(__c);
1564   ++__extracted;
1565   __c = __in.rdbuf()->snextc();
1566 }
1567
1568       if (_Traits::eq_int_type(__c, __eof))
1569 __err |= __ios_base::eofbit;
1570       else if (_Traits::eq_int_type(__c, __idelim))
1571 {
1572   ++__extracted;   
1573   __in.rdbuf()->sbumpc();
1574 }
1575       else
1576 __err |= __ios_base::failbit;
1577     }
1578   __catch(__cxxabiv1::__forced_unwind&)
1579     {
1580       __in._M_setstate(__ios_base::badbit);
1581       __throw_exception_again;
1582     }
1583   __catch(...)
1584     {
1585       // _GLIBCXX_RESOLVE_LIB_DEFECTS
1586       // 91. Description of operator>> and getline() for string<>
1587       // might cause endless loop
1588       __in._M_setstate(__ios_base::badbit);
1589     }
1590 }
1591      if (!__extracted)
1592 __err |= __ios_base::failbit;
1593      if (__err)
1594 __in.setstate(__err);
1595      return __in;
1596    }
1597
1598  // Inhibit implicit instantiations for required instantiations,
1599  // which are defined via explicit instantiations elsewhere.
1600#if _GLIBCXX_EXTERN_TEMPLATE
1601  // The explicit instantiations definitions in src/c++11/string-inst.cc
1602  // are compiled as C++14, so the new C++17 members aren't instantiated.
1603  // Until those definitions are compiled as C++17 suppress the declaration,
1604  // so C++17 code will implicitly instantiate std::string and std::wstring
1605  // as needed.
1606# if __cplusplus <= 201402L && _GLIBCXX_EXTERN_TEMPLATE > 0
1607  extern template class basic_string<char>;
1608# elif ! _GLIBCXX_USE_CXX11_ABI
1609  // Still need to prevent implicit instantiation of the COW empty rep,
1610  // to ensure the definition in libstdc++.so is unique (PR 86138).
1611  extern template basic_string<char>::size_type
1612    basic_string<char>::_Rep::_S_empty_rep_storage[];
1613# endif
1614
1615  extern template
1616    basic_istream<char>&
1617    operator>>(basic_istream<char>&, string&);
1618  extern template
1619    basic_ostream<char>&
1620    operator<<(basic_ostream<char>&, const string&);
1621  extern template
1622    basic_istream<char>&
1623    getline(basic_istream<char>&, string&, char);
1624  extern template
1625    basic_istream<char>&
1626    getline(basic_istream<char>&, string&);
1627
1628#ifdef _GLIBCXX_USE_WCHAR_T
1629# if __cplusplus <= 201402L && _GLIBCXX_EXTERN_TEMPLATE > 0
1630  extern template class basic_string<wchar_t>;
1631# elif ! _GLIBCXX_USE_CXX11_ABI
1632  extern template basic_string<wchar_t>::size_type
1633    basic_string<wchar_t>::_Rep::_S_empty_rep_storage[];
1634# endif
1635
1636  extern template
1637    basic_istream<wchar_t>&
1638    operator>>(basic_istream<wchar_t>&, wstring&);
1639  extern template
1640    basic_ostream<wchar_t>&
1641    operator<<(basic_ostream<wchar_t>&, const wstring&);
1642  extern template
1643    basic_istream<wchar_t>&
1644    getline(basic_istream<wchar_t>&, wstring&, wchar_t);
1645  extern template
1646    basic_istream<wchar_t>&
1647    getline(basic_istream<wchar_t>&, wstring&);
1648#endif // _GLIBCXX_USE_WCHAR_T
1649#endif // _GLIBCXX_EXTERN_TEMPLATE
1650
1651_GLIBCXX_END_NAMESPACE_VERSION
1652} // namespace std
1653
1654#endif
1655
std::basic_string::npos
std::basic_string::swap
std::basic_string::_M_create
std::basic_string::_M_construct
std::basic_string::_M_construct
std::basic_string::_M_construct
std::basic_string::_M_assign
std::basic_string::reserve
std::basic_string::_M_mutate
std::basic_string::_M_erase
std::basic_string::resize
std::basic_string::_M_append
std::basic_string::_M_replace_dispatch
std::basic_string::_M_replace_aux
std::basic_string::_M_replace
std::basic_string::copy
std::basic_string::find
std::basic_string::find
std::basic_string::rfind
std::basic_string::rfind
std::basic_string::find_first_of
std::basic_string::find_last_of
std::basic_string::find_first_not_of
std::basic_string::find_first_not_of
std::basic_string::find_last_not_of
std::basic_string::find_last_not_of
std::basic_string::compare
std::basic_string::compare
std::basic_string::compare
std::basic_string::compare
std::basic_string::compare
CodeThinker, Enjoy your reading code