xref: /freebsd-12.1/contrib/libc++/include/string (revision 99eef682)
1// -*- C++ -*-
2//===--------------------------- string -----------------------------------===//
3//
4//                     The LLVM Compiler Infrastructure
5//
6// This file is distributed under the University of Illinois Open Source
7// License. See LICENSE.TXT for details.
8//
9//===----------------------------------------------------------------------===//
10
11#ifndef _LIBCPP_STRING
12#define _LIBCPP_STRING
13
14/*
15    string synopsis
16
17namespace std
18{
19
20template <class stateT>
21class fpos
22{
23private:
24    stateT st;
25public:
26    fpos(streamoff = streamoff());
27
28    operator streamoff() const;
29
30    stateT state() const;
31    void state(stateT);
32
33    fpos& operator+=(streamoff);
34    fpos  operator+ (streamoff) const;
35    fpos& operator-=(streamoff);
36    fpos  operator- (streamoff) const;
37};
38
39template <class stateT> streamoff operator-(const fpos<stateT>& x, const fpos<stateT>& y);
40
41template <class stateT> bool operator==(const fpos<stateT>& x, const fpos<stateT>& y);
42template <class stateT> bool operator!=(const fpos<stateT>& x, const fpos<stateT>& y);
43
44template <class charT>
45struct char_traits
46{
47    typedef charT     char_type;
48    typedef ...       int_type;
49    typedef streamoff off_type;
50    typedef streampos pos_type;
51    typedef mbstate_t state_type;
52
53    static void assign(char_type& c1, const char_type& c2) noexcept;
54    static constexpr bool eq(char_type c1, char_type c2) noexcept;
55    static constexpr bool lt(char_type c1, char_type c2) noexcept;
56
57    static int              compare(const char_type* s1, const char_type* s2, size_t n);
58    static size_t           length(const char_type* s);
59    static const char_type* find(const char_type* s, size_t n, const char_type& a);
60    static char_type*       move(char_type* s1, const char_type* s2, size_t n);
61    static char_type*       copy(char_type* s1, const char_type* s2, size_t n);
62    static char_type*       assign(char_type* s, size_t n, char_type a);
63
64    static constexpr int_type  not_eof(int_type c) noexcept;
65    static constexpr char_type to_char_type(int_type c) noexcept;
66    static constexpr int_type  to_int_type(char_type c) noexcept;
67    static constexpr bool      eq_int_type(int_type c1, int_type c2) noexcept;
68    static constexpr int_type  eof() noexcept;
69};
70
71template <> struct char_traits<char>;
72template <> struct char_traits<wchar_t>;
73
74template<class charT, class traits = char_traits<charT>, class Allocator = allocator<charT> >
75class basic_string
76{
77public:
78// types:
79    typedef traits traits_type;
80    typedef typename traits_type::char_type value_type;
81    typedef Allocator allocator_type;
82    typedef typename allocator_type::size_type size_type;
83    typedef typename allocator_type::difference_type difference_type;
84    typedef typename allocator_type::reference reference;
85    typedef typename allocator_type::const_reference const_reference;
86    typedef typename allocator_type::pointer pointer;
87    typedef typename allocator_type::const_pointer const_pointer;
88    typedef implementation-defined iterator;
89    typedef implementation-defined const_iterator;
90    typedef std::reverse_iterator<iterator> reverse_iterator;
91    typedef std::reverse_iterator<const_iterator> const_reverse_iterator;
92
93    static const size_type npos = -1;
94
95    basic_string()
96        noexcept(is_nothrow_default_constructible<allocator_type>::value);
97    explicit basic_string(const allocator_type& a);
98    basic_string(const basic_string& str);
99    basic_string(basic_string&& str)
100        noexcept(is_nothrow_move_constructible<allocator_type>::value);
101    basic_string(const basic_string& str, size_type pos, size_type n = npos,
102                 const allocator_type& a = allocator_type());
103    basic_string(const_pointer s, const allocator_type& a = allocator_type());
104    basic_string(const_pointer s, size_type n, const allocator_type& a = allocator_type());
105    basic_string(size_type n, value_type c, const allocator_type& a = allocator_type());
106    template<class InputIterator>
107        basic_string(InputIterator begin, InputIterator end,
108                     const allocator_type& a = allocator_type());
109    basic_string(initializer_list<value_type>, const Allocator& = Allocator());
110    basic_string(const basic_string&, const Allocator&);
111    basic_string(basic_string&&, const Allocator&);
112
113    ~basic_string();
114
115    basic_string& operator=(const basic_string& str);
116    basic_string& operator=(basic_string&& str)
117        noexcept(
118             allocator_type::propagate_on_container_move_assignment::value &&
119             is_nothrow_move_assignable<allocator_type>::value);
120    basic_string& operator=(const_pointer s);
121    basic_string& operator=(value_type c);
122    basic_string& operator=(initializer_list<value_type>);
123
124    iterator       begin() noexcept;
125    const_iterator begin() const noexcept;
126    iterator       end() noexcept;
127    const_iterator end() const noexcept;
128
129    reverse_iterator       rbegin() noexcept;
130    const_reverse_iterator rbegin() const noexcept;
131    reverse_iterator       rend() noexcept;
132    const_reverse_iterator rend() const noexcept;
133
134    const_iterator         cbegin() const noexcept;
135    const_iterator         cend() const noexcept;
136    const_reverse_iterator crbegin() const noexcept;
137    const_reverse_iterator crend() const noexcept;
138
139    size_type size() const noexcept;
140    size_type length() const noexcept;
141    size_type max_size() const noexcept;
142    size_type capacity() const noexcept;
143
144    void resize(size_type n, value_type c);
145    void resize(size_type n);
146
147    void reserve(size_type res_arg = 0);
148    void shrink_to_fit();
149    void clear() noexcept;
150    bool empty() const noexcept;
151
152    const_reference operator[](size_type pos) const;
153    reference       operator[](size_type pos);
154
155    const_reference at(size_type n) const;
156    reference       at(size_type n);
157
158    basic_string& operator+=(const basic_string& str);
159    basic_string& operator+=(const_pointer s);
160    basic_string& operator+=(value_type c);
161    basic_string& operator+=(initializer_list<value_type>);
162
163    basic_string& append(const basic_string& str);
164    basic_string& append(const basic_string& str, size_type pos, size_type n);
165    basic_string& append(const_pointer s, size_type n);
166    basic_string& append(const_pointer s);
167    basic_string& append(size_type n, value_type c);
168    template<class InputIterator>
169        basic_string& append(InputIterator first, InputIterator last);
170    basic_string& append(initializer_list<value_type>);
171
172    void push_back(value_type c);
173    void pop_back();
174    reference       front();
175    const_reference front() const;
176    reference       back();
177    const_reference back() const;
178
179    basic_string& assign(const basic_string& str);
180    basic_string& assign(basic_string&& str);
181    basic_string& assign(const basic_string& str, size_type pos, size_type n);
182    basic_string& assign(const_pointer s, size_type n);
183    basic_string& assign(const_pointer s);
184    basic_string& assign(size_type n, value_type c);
185    template<class InputIterator>
186        basic_string& assign(InputIterator first, InputIterator last);
187    basic_string& assign(initializer_list<value_type>);
188
189    basic_string& insert(size_type pos1, const basic_string& str);
190    basic_string& insert(size_type pos1, const basic_string& str,
191                         size_type pos2, size_type n);
192    basic_string& insert(size_type pos, const_pointer s, size_type n);
193    basic_string& insert(size_type pos, const_pointer s);
194    basic_string& insert(size_type pos, size_type n, value_type c);
195    iterator      insert(const_iterator p, value_type c);
196    iterator      insert(const_iterator p, size_type n, value_type c);
197    template<class InputIterator>
198        iterator insert(const_iterator p, InputIterator first, InputIterator last);
199    iterator      insert(const_iterator p, initializer_list<value_type>);
200
201    basic_string& erase(size_type pos = 0, size_type n = npos);
202    iterator      erase(const_iterator position);
203    iterator      erase(const_iterator first, const_iterator last);
204
205    basic_string& replace(size_type pos1, size_type n1, const basic_string& str);
206    basic_string& replace(size_type pos1, size_type n1, const basic_string& str,
207                          size_type pos2, size_type n2);
208    basic_string& replace(size_type pos, size_type n1, const_pointer s, size_type n2);
209    basic_string& replace(size_type pos, size_type n1, const_pointer s);
210    basic_string& replace(size_type pos, size_type n1, size_type n2, value_type c);
211    basic_string& replace(const_iterator i1, const_iterator i2, const basic_string& str);
212    basic_string& replace(const_iterator i1, const_iterator i2, const_pointer s, size_type n);
213    basic_string& replace(const_iterator i1, const_iterator i2, const_pointer s);
214    basic_string& replace(const_iterator i1, const_iterator i2, size_type n, value_type c);
215    template<class InputIterator>
216        basic_string& replace(const_iterator i1, const_iterator i2, InputIterator j1, InputIterator j2);
217    basic_string& replace(const_iterator i1, const_iterator i2, initializer_list<value_type>);
218
219    size_type copy(pointer s, size_type n, size_type pos = 0) const;
220    basic_string substr(size_type pos = 0, size_type n = npos) const;
221
222    void swap(basic_string& str)
223        noexcept(!allocator_type::propagate_on_container_swap::value ||
224                 __is_nothrow_swappable<allocator_type>::value)
225
226    const_pointer c_str() const noexcept;
227    const_pointer data() const noexcept;
228
229    allocator_type get_allocator() const noexcept;
230
231    size_type find(const basic_string& str, size_type pos = 0) const noexcept;
232    size_type find(const_pointer s, size_type pos, size_type n) const noexcept;
233    size_type find(const_pointer s, size_type pos = 0) const noexcept;
234    size_type find(value_type c, size_type pos = 0) const noexcept;
235
236    size_type rfind(const basic_string& str, size_type pos = npos) const noexcept;
237    size_type rfind(const_pointer s, size_type pos, size_type n) const noexcept;
238    size_type rfind(const_pointer s, size_type pos = npos) const noexcept;
239    size_type rfind(value_type c, size_type pos = npos) const noexcept;
240
241    size_type find_first_of(const basic_string& str, size_type pos = 0) const noexcept;
242    size_type find_first_of(const_pointer s, size_type pos, size_type n) const noexcept;
243    size_type find_first_of(const_pointer s, size_type pos = 0) const noexcept;
244    size_type find_first_of(value_type c, size_type pos = 0) const noexcept;
245
246    size_type find_last_of(const basic_string& str, size_type pos = npos) const noexcept;
247    size_type find_last_of(const_pointer s, size_type pos, size_type n) const noexcept;
248    size_type find_last_of(const_pointer s, size_type pos = npos) const noexcept;
249    size_type find_last_of(value_type c, size_type pos = npos) const noexcept;
250
251    size_type find_first_not_of(const basic_string& str, size_type pos = 0) const noexcept;
252    size_type find_first_not_of(const_pointer s, size_type pos, size_type n) const noexcept;
253    size_type find_first_not_of(const_pointer s, size_type pos = 0) const noexcept;
254    size_type find_first_not_of(value_type c, size_type pos = 0) const noexcept;
255
256    size_type find_last_not_of(const basic_string& str, size_type pos = npos) const noexcept;
257    size_type find_last_not_of(const_pointer s, size_type pos, size_type n) const noexcept;
258    size_type find_last_not_of(const_pointer s, size_type pos = npos) const noexcept;
259    size_type find_last_not_of(value_type c, size_type pos = npos) const noexcept;
260
261    int compare(const basic_string& str) const noexcept;
262    int compare(size_type pos1, size_type n1, const basic_string& str) const;
263    int compare(size_type pos1, size_type n1, const basic_string& str,
264                size_type pos2, size_type n2) const;
265    int compare(const_pointer s) const noexcept;
266    int compare(size_type pos1, size_type n1, const_pointer s) const;
267    int compare(size_type pos1, size_type n1, const_pointer s, size_type n2) const;
268
269    bool __invariants() const;
270};
271
272template<class charT, class traits, class Allocator>
273basic_string<charT, traits, Allocator>
274operator+(const basic_string<charT, traits, Allocator>& lhs,
275          const basic_string<charT, traits, Allocator>& rhs);
276
277template<class charT, class traits, class Allocator>
278basic_string<charT, traits, Allocator>
279operator+(const charT* lhs , const basic_string<charT,traits,Allocator>&rhs);
280
281template<class charT, class traits, class Allocator>
282basic_string<charT, traits, Allocator>
283operator+(charT lhs, const basic_string<charT,traits,Allocator>& rhs);
284
285template<class charT, class traits, class Allocator>
286basic_string<charT, traits, Allocator>
287operator+(const basic_string<charT, traits, Allocator>& lhs, const charT* rhs);
288
289template<class charT, class traits, class Allocator>
290basic_string<charT, traits, Allocator>
291operator+(const basic_string<charT, traits, Allocator>& lhs, charT rhs);
292
293template<class charT, class traits, class Allocator>
294bool operator==(const basic_string<charT, traits, Allocator>& lhs,
295                const basic_string<charT, traits, Allocator>& rhs) noexcept;
296
297template<class charT, class traits, class Allocator>
298bool operator==(const charT* lhs, const basic_string<charT, traits, Allocator>& rhs) noexcept;
299
300template<class charT, class traits, class Allocator>
301bool operator==(const basic_string<charT,traits,Allocator>& lhs, const charT* rhs) noexcept;
302
303template<class charT, class traits, class Allocator>
304bool operator!=(const basic_string<charT,traits,Allocator>& lhs,
305                const basic_string<charT, traits, Allocator>& rhs) noexcept;
306
307template<class charT, class traits, class Allocator>
308bool operator!=(const charT* lhs, const basic_string<charT, traits, Allocator>& rhs) noexcept;
309
310template<class charT, class traits, class Allocator>
311bool operator!=(const basic_string<charT, traits, Allocator>& lhs, const charT* rhs) noexcept;
312
313template<class charT, class traits, class Allocator>
314bool operator< (const basic_string<charT, traits, Allocator>& lhs,
315                const basic_string<charT, traits, Allocator>& rhs) noexcept;
316
317template<class charT, class traits, class Allocator>
318bool operator< (const basic_string<charT, traits, Allocator>& lhs, const charT* rhs) noexcept;
319
320template<class charT, class traits, class Allocator>
321bool operator< (const charT* lhs, const basic_string<charT, traits, Allocator>& rhs) noexcept;
322
323template<class charT, class traits, class Allocator>
324bool operator> (const basic_string<charT, traits, Allocator>& lhs,
325                const basic_string<charT, traits, Allocator>& rhs) noexcept;
326
327template<class charT, class traits, class Allocator>
328bool operator> (const basic_string<charT, traits, Allocator>& lhs, const charT* rhs) noexcept;
329
330template<class charT, class traits, class Allocator>
331bool operator> (const charT* lhs, const basic_string<charT, traits, Allocator>& rhs) noexcept;
332
333template<class charT, class traits, class Allocator>
334bool operator<=(const basic_string<charT, traits, Allocator>& lhs,
335                const basic_string<charT, traits, Allocator>& rhs) noexcept;
336
337template<class charT, class traits, class Allocator>
338bool operator<=(const basic_string<charT, traits, Allocator>& lhs, const charT* rhs) noexcept;
339
340template<class charT, class traits, class Allocator>
341bool operator<=(const charT* lhs, const basic_string<charT, traits, Allocator>& rhs) noexcept;
342
343template<class charT, class traits, class Allocator>
344bool operator>=(const basic_string<charT, traits, Allocator>& lhs,
345                const basic_string<charT, traits, Allocator>& rhs) noexcept;
346
347template<class charT, class traits, class Allocator>
348bool operator>=(const basic_string<charT, traits, Allocator>& lhs, const charT* rhs) noexcept;
349
350template<class charT, class traits, class Allocator>
351bool operator>=(const charT* lhs, const basic_string<charT, traits, Allocator>& rhs) noexcept;
352
353template<class charT, class traits, class Allocator>
354void swap(basic_string<charT, traits, Allocator>& lhs,
355          basic_string<charT, traits, Allocator>& rhs)
356            noexcept(noexcept(lhs.swap(rhs)));
357
358template<class charT, class traits, class Allocator>
359basic_istream<charT, traits>&
360operator>>(basic_istream<charT, traits>& is, basic_string<charT, traits, Allocator>& str);
361
362template<class charT, class traits, class Allocator>
363basic_ostream<charT, traits>&
364operator<<(basic_ostream<charT, traits>& os, const basic_string<charT, traits, Allocator>& str);
365
366template<class charT, class traits, class Allocator>
367basic_istream<charT, traits>&
368getline(basic_istream<charT, traits>& is, basic_string<charT, traits, Allocator>& str,
369        charT delim);
370
371template<class charT, class traits, class Allocator>
372basic_istream<charT, traits>&
373getline(basic_istream<charT, traits>& is, basic_string<charT, traits, Allocator>& str);
374
375typedef basic_string<char>    string;
376typedef basic_string<wchar_t> wstring;
377typedef basic_string<char16_t> u16string;
378typedef basic_string<char32_t> u32string;
379
380int                stoi  (const string& str, size_t* idx = 0, int base = 10);
381long               stol  (const string& str, size_t* idx = 0, int base = 10);
382unsigned long      stoul (const string& str, size_t* idx = 0, int base = 10);
383long long          stoll (const string& str, size_t* idx = 0, int base = 10);
384unsigned long long stoull(const string& str, size_t* idx = 0, int base = 10);
385
386float       stof (const string& str, size_t* idx = 0);
387double      stod (const string& str, size_t* idx = 0);
388long double stold(const string& str, size_t* idx = 0);
389
390string to_string(int val);
391string to_string(unsigned val);
392string to_string(long val);
393string to_string(unsigned long val);
394string to_string(long long val);
395string to_string(unsigned long long val);
396string to_string(float val);
397string to_string(double val);
398string to_string(long double val);
399
400int                stoi  (const wstring& str, size_t* idx = 0, int base = 10);
401long               stol  (const wstring& str, size_t* idx = 0, int base = 10);
402unsigned long      stoul (const wstring& str, size_t* idx = 0, int base = 10);
403long long          stoll (const wstring& str, size_t* idx = 0, int base = 10);
404unsigned long long stoull(const wstring& str, size_t* idx = 0, int base = 10);
405
406float       stof (const wstring& str, size_t* idx = 0);
407double      stod (const wstring& str, size_t* idx = 0);
408long double stold(const wstring& str, size_t* idx = 0);
409
410wstring to_wstring(int val);
411wstring to_wstring(unsigned val);
412wstring to_wstring(long val);
413wstring to_wstring(unsigned long val);
414wstring to_wstring(long long val);
415wstring to_wstring(unsigned long long val);
416wstring to_wstring(float val);
417wstring to_wstring(double val);
418wstring to_wstring(long double val);
419
420template <> struct hash<string>;
421template <> struct hash<u16string>;
422template <> struct hash<u32string>;
423template <> struct hash<wstring>;
424
425}  // std
426
427*/
428
429#include <__config>
430#include <iosfwd>
431#include <cstring>
432#include <cstdio>  // For EOF.
433#include <cwchar>
434#include <algorithm>
435#include <iterator>
436#include <utility>
437#include <memory>
438#include <stdexcept>
439#include <type_traits>
440#include <initializer_list>
441#include <__functional_base>
442#ifndef _LIBCPP_HAS_NO_UNICODE_CHARS
443#include <cstdint>
444#endif
445#if defined(_LIBCPP_NO_EXCEPTIONS) || defined(_LIBCPP_DEBUG)
446#include <cassert>
447#endif
448
449#include <__undef_min_max>
450
451#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
452#pragma GCC system_header
453#endif
454
455_LIBCPP_BEGIN_NAMESPACE_STD
456
457// fpos
458
459template <class _StateT>
460class _LIBCPP_TYPE_VIS fpos
461{
462private:
463    _StateT __st_;
464    streamoff __off_;
465public:
466    _LIBCPP_INLINE_VISIBILITY fpos(streamoff __off = streamoff()) : __st_(), __off_(__off) {}
467
468    _LIBCPP_INLINE_VISIBILITY operator streamoff() const {return __off_;}
469
470    _LIBCPP_INLINE_VISIBILITY _StateT state() const {return __st_;}
471    _LIBCPP_INLINE_VISIBILITY void state(_StateT __st) {__st_ = __st;}
472
473    _LIBCPP_INLINE_VISIBILITY fpos& operator+=(streamoff __off) {__off_ += __off; return *this;}
474    _LIBCPP_INLINE_VISIBILITY fpos  operator+ (streamoff __off) const {fpos __t(*this); __t += __off; return __t;}
475    _LIBCPP_INLINE_VISIBILITY fpos& operator-=(streamoff __off) {__off_ -= __off; return *this;}
476    _LIBCPP_INLINE_VISIBILITY fpos  operator- (streamoff __off) const {fpos __t(*this); __t -= __off; return __t;}
477};
478
479template <class _StateT>
480inline _LIBCPP_INLINE_VISIBILITY
481streamoff operator-(const fpos<_StateT>& __x, const fpos<_StateT>& __y)
482    {return streamoff(__x) - streamoff(__y);}
483
484template <class _StateT>
485inline _LIBCPP_INLINE_VISIBILITY
486bool operator==(const fpos<_StateT>& __x, const fpos<_StateT>& __y)
487    {return streamoff(__x) == streamoff(__y);}
488
489template <class _StateT>
490inline _LIBCPP_INLINE_VISIBILITY
491bool operator!=(const fpos<_StateT>& __x, const fpos<_StateT>& __y)
492    {return streamoff(__x) != streamoff(__y);}
493
494// char_traits
495
496template <class _CharT>
497struct _LIBCPP_TYPE_VIS char_traits
498{
499    typedef _CharT    char_type;
500    typedef int       int_type;
501    typedef streamoff off_type;
502    typedef streampos pos_type;
503    typedef mbstate_t state_type;
504
505    _LIBCPP_INLINE_VISIBILITY
506    static void assign(char_type& __c1, const char_type& __c2) _NOEXCEPT
507        {__c1 = __c2;}
508    _LIBCPP_INLINE_VISIBILITY
509    static _LIBCPP_CONSTEXPR bool eq(char_type __c1, char_type __c2) _NOEXCEPT
510        {return __c1 == __c2;}
511    _LIBCPP_INLINE_VISIBILITY
512    static _LIBCPP_CONSTEXPR bool lt(char_type __c1, char_type __c2) _NOEXCEPT
513        {return __c1 < __c2;}
514
515    static int              compare(const char_type* __s1, const char_type* __s2, size_t __n);
516    static size_t           length(const char_type* __s);
517    static const char_type* find(const char_type* __s, size_t __n, const char_type& __a);
518    static char_type*       move(char_type* __s1, const char_type* __s2, size_t __n);
519    static char_type*       copy(char_type* __s1, const char_type* __s2, size_t __n);
520    static char_type*       assign(char_type* __s, size_t __n, char_type __a);
521
522    _LIBCPP_INLINE_VISIBILITY
523    static _LIBCPP_CONSTEXPR int_type  not_eof(int_type __c) _NOEXCEPT
524        {return eq_int_type(__c, eof()) ? ~eof() : __c;}
525    _LIBCPP_INLINE_VISIBILITY
526    static _LIBCPP_CONSTEXPR char_type to_char_type(int_type __c) _NOEXCEPT
527        {return char_type(__c);}
528    _LIBCPP_INLINE_VISIBILITY
529    static _LIBCPP_CONSTEXPR int_type  to_int_type(char_type __c) _NOEXCEPT
530        {return int_type(__c);}
531    _LIBCPP_INLINE_VISIBILITY
532    static _LIBCPP_CONSTEXPR bool      eq_int_type(int_type __c1, int_type __c2) _NOEXCEPT
533        {return __c1 == __c2;}
534    _LIBCPP_INLINE_VISIBILITY
535    static _LIBCPP_CONSTEXPR int_type  eof() _NOEXCEPT
536        {return int_type(EOF);}
537};
538
539template <class _CharT>
540int
541char_traits<_CharT>::compare(const char_type* __s1, const char_type* __s2, size_t __n)
542{
543    for (; __n; --__n, ++__s1, ++__s2)
544    {
545        if (lt(*__s1, *__s2))
546            return -1;
547        if (lt(*__s2, *__s1))
548            return 1;
549    }
550    return 0;
551}
552
553template <class _CharT>
554inline _LIBCPP_INLINE_VISIBILITY
555size_t
556char_traits<_CharT>::length(const char_type* __s)
557{
558    size_t __len = 0;
559    for (; !eq(*__s, char_type(0)); ++__s)
560        ++__len;
561    return __len;
562}
563
564template <class _CharT>
565inline _LIBCPP_INLINE_VISIBILITY
566const _CharT*
567char_traits<_CharT>::find(const char_type* __s, size_t __n, const char_type& __a)
568{
569    for (; __n; --__n)
570    {
571        if (eq(*__s, __a))
572            return __s;
573        ++__s;
574    }
575    return 0;
576}
577
578template <class _CharT>
579_CharT*
580char_traits<_CharT>::move(char_type* __s1, const char_type* __s2, size_t __n)
581{
582    char_type* __r = __s1;
583    if (__s1 < __s2)
584    {
585        for (; __n; --__n, ++__s1, ++__s2)
586            assign(*__s1, *__s2);
587    }
588    else if (__s2 < __s1)
589    {
590        __s1 += __n;
591        __s2 += __n;
592        for (; __n; --__n)
593            assign(*--__s1, *--__s2);
594    }
595    return __r;
596}
597
598template <class _CharT>
599inline _LIBCPP_INLINE_VISIBILITY
600_CharT*
601char_traits<_CharT>::copy(char_type* __s1, const char_type* __s2, size_t __n)
602{
603    char_type* __r = __s1;
604    for (; __n; --__n, ++__s1, ++__s2)
605        assign(*__s1, *__s2);
606    return __r;
607}
608
609template <class _CharT>
610inline _LIBCPP_INLINE_VISIBILITY
611_CharT*
612char_traits<_CharT>::assign(char_type* __s, size_t __n, char_type __a)
613{
614    char_type* __r = __s;
615    for (; __n; --__n, ++__s)
616        assign(*__s, __a);
617    return __r;
618}
619
620// char_traits<char>
621
622template <>
623struct _LIBCPP_TYPE_VIS char_traits<char>
624{
625    typedef char      char_type;
626    typedef int       int_type;
627    typedef streamoff off_type;
628    typedef streampos pos_type;
629    typedef mbstate_t state_type;
630
631    _LIBCPP_INLINE_VISIBILITY
632    static void assign(char_type& __c1, const char_type& __c2) _NOEXCEPT
633        {__c1 = __c2;}
634    _LIBCPP_INLINE_VISIBILITY
635    static _LIBCPP_CONSTEXPR bool eq(char_type __c1, char_type __c2) _NOEXCEPT
636            {return __c1 == __c2;}
637    _LIBCPP_INLINE_VISIBILITY
638    static _LIBCPP_CONSTEXPR bool lt(char_type __c1, char_type __c2) _NOEXCEPT
639        {return (unsigned char)__c1 < (unsigned char)__c2;}
640
641    _LIBCPP_INLINE_VISIBILITY
642    static int compare(const char_type* __s1, const char_type* __s2, size_t __n)
643        {return memcmp(__s1, __s2, __n);}
644    _LIBCPP_INLINE_VISIBILITY
645    static size_t length(const char_type* __s) {return strlen(__s);}
646    _LIBCPP_INLINE_VISIBILITY
647    static const char_type* find(const char_type* __s, size_t __n, const char_type& __a)
648        {return (const char_type*)memchr(__s, to_int_type(__a), __n);}
649    _LIBCPP_INLINE_VISIBILITY
650    static char_type* move(char_type* __s1, const char_type* __s2, size_t __n)
651        {return (char_type*)memmove(__s1, __s2, __n);}
652    _LIBCPP_INLINE_VISIBILITY
653    static char_type* copy(char_type* __s1, const char_type* __s2, size_t __n)
654        {return (char_type*)memcpy(__s1, __s2, __n);}
655    _LIBCPP_INLINE_VISIBILITY
656    static char_type* assign(char_type* __s, size_t __n, char_type __a)
657        {return (char_type*)memset(__s, to_int_type(__a), __n);}
658
659    _LIBCPP_INLINE_VISIBILITY
660    static _LIBCPP_CONSTEXPR int_type  not_eof(int_type __c) _NOEXCEPT
661        {return eq_int_type(__c, eof()) ? ~eof() : __c;}
662    _LIBCPP_INLINE_VISIBILITY
663    static _LIBCPP_CONSTEXPR char_type to_char_type(int_type __c) _NOEXCEPT
664        {return char_type(__c);}
665    _LIBCPP_INLINE_VISIBILITY
666    static _LIBCPP_CONSTEXPR int_type to_int_type(char_type __c) _NOEXCEPT
667        {return int_type((unsigned char)__c);}
668    _LIBCPP_INLINE_VISIBILITY
669    static _LIBCPP_CONSTEXPR bool eq_int_type(int_type __c1, int_type __c2) _NOEXCEPT
670        {return __c1 == __c2;}
671    _LIBCPP_INLINE_VISIBILITY
672    static _LIBCPP_CONSTEXPR int_type  eof() _NOEXCEPT
673        {return int_type(EOF);}
674};
675
676// char_traits<wchar_t>
677
678template <>
679struct _LIBCPP_TYPE_VIS char_traits<wchar_t>
680{
681    typedef wchar_t   char_type;
682    typedef wint_t    int_type;
683    typedef streamoff off_type;
684    typedef streampos pos_type;
685    typedef mbstate_t state_type;
686
687    _LIBCPP_INLINE_VISIBILITY
688    static void assign(char_type& __c1, const char_type& __c2) _NOEXCEPT
689        {__c1 = __c2;}
690    _LIBCPP_INLINE_VISIBILITY
691    static _LIBCPP_CONSTEXPR bool eq(char_type __c1, char_type __c2) _NOEXCEPT
692        {return __c1 == __c2;}
693    _LIBCPP_INLINE_VISIBILITY
694    static _LIBCPP_CONSTEXPR bool lt(char_type __c1, char_type __c2) _NOEXCEPT
695        {return __c1 < __c2;}
696
697    _LIBCPP_INLINE_VISIBILITY
698    static int compare(const char_type* __s1, const char_type* __s2, size_t __n)
699        {return wmemcmp(__s1, __s2, __n);}
700    _LIBCPP_INLINE_VISIBILITY
701    static size_t length(const char_type* __s)
702        {return wcslen(__s);}
703    _LIBCPP_INLINE_VISIBILITY
704    static const char_type* find(const char_type* __s, size_t __n, const char_type& __a)
705        {return (const char_type*)wmemchr(__s, __a, __n);}
706    _LIBCPP_INLINE_VISIBILITY
707    static char_type* move(char_type* __s1, const char_type* __s2, size_t __n)
708        {return (char_type*)wmemmove(__s1, __s2, __n);}
709    _LIBCPP_INLINE_VISIBILITY
710    static char_type* copy(char_type* __s1, const char_type* __s2, size_t __n)
711        {return (char_type*)wmemcpy(__s1, __s2, __n);}
712    _LIBCPP_INLINE_VISIBILITY
713    static char_type* assign(char_type* __s, size_t __n, char_type __a)
714        {return (char_type*)wmemset(__s, __a, __n);}
715
716    _LIBCPP_INLINE_VISIBILITY
717    static _LIBCPP_CONSTEXPR int_type  not_eof(int_type __c) _NOEXCEPT
718        {return eq_int_type(__c, eof()) ? ~eof() : __c;}
719    _LIBCPP_INLINE_VISIBILITY
720    static _LIBCPP_CONSTEXPR char_type to_char_type(int_type __c) _NOEXCEPT
721        {return char_type(__c);}
722    _LIBCPP_INLINE_VISIBILITY
723    static _LIBCPP_CONSTEXPR int_type to_int_type(char_type __c) _NOEXCEPT
724        {return int_type(__c);}
725    _LIBCPP_INLINE_VISIBILITY
726    static _LIBCPP_CONSTEXPR bool eq_int_type(int_type __c1, int_type __c2) _NOEXCEPT
727        {return __c1 == __c2;}
728    _LIBCPP_INLINE_VISIBILITY
729    static _LIBCPP_CONSTEXPR int_type eof() _NOEXCEPT
730        {return int_type(WEOF);}
731};
732
733#ifndef _LIBCPP_HAS_NO_UNICODE_CHARS
734
735template <>
736struct _LIBCPP_TYPE_VIS char_traits<char16_t>
737{
738    typedef char16_t       char_type;
739    typedef uint_least16_t int_type;
740    typedef streamoff      off_type;
741    typedef u16streampos   pos_type;
742    typedef mbstate_t      state_type;
743
744    _LIBCPP_INLINE_VISIBILITY
745    static void assign(char_type& __c1, const char_type& __c2) _NOEXCEPT
746        {__c1 = __c2;}
747    _LIBCPP_INLINE_VISIBILITY
748    static _LIBCPP_CONSTEXPR bool eq(char_type __c1, char_type __c2) _NOEXCEPT
749        {return __c1 == __c2;}
750    _LIBCPP_INLINE_VISIBILITY
751    static _LIBCPP_CONSTEXPR bool lt(char_type __c1, char_type __c2) _NOEXCEPT
752        {return __c1 < __c2;}
753
754    static int              compare(const char_type* __s1, const char_type* __s2, size_t __n);
755    static size_t           length(const char_type* __s);
756    static const char_type* find(const char_type* __s, size_t __n, const char_type& __a);
757    static char_type*       move(char_type* __s1, const char_type* __s2, size_t __n);
758    static char_type*       copy(char_type* __s1, const char_type* __s2, size_t __n);
759    static char_type*       assign(char_type* __s, size_t __n, char_type __a);
760
761    _LIBCPP_INLINE_VISIBILITY
762    static _LIBCPP_CONSTEXPR int_type  not_eof(int_type __c) _NOEXCEPT
763        {return eq_int_type(__c, eof()) ? ~eof() : __c;}
764    _LIBCPP_INLINE_VISIBILITY
765    static _LIBCPP_CONSTEXPR char_type to_char_type(int_type __c) _NOEXCEPT
766        {return char_type(__c);}
767    _LIBCPP_INLINE_VISIBILITY
768    static _LIBCPP_CONSTEXPR int_type to_int_type(char_type __c) _NOEXCEPT
769        {return int_type(__c);}
770    _LIBCPP_INLINE_VISIBILITY
771    static _LIBCPP_CONSTEXPR bool eq_int_type(int_type __c1, int_type __c2) _NOEXCEPT
772        {return __c1 == __c2;}
773    _LIBCPP_INLINE_VISIBILITY
774    static _LIBCPP_CONSTEXPR int_type eof() _NOEXCEPT
775        {return int_type(0xDFFF);}
776};
777
778inline _LIBCPP_INLINE_VISIBILITY
779int
780char_traits<char16_t>::compare(const char_type* __s1, const char_type* __s2, size_t __n)
781{
782    for (; __n; --__n, ++__s1, ++__s2)
783    {
784        if (lt(*__s1, *__s2))
785            return -1;
786        if (lt(*__s2, *__s1))
787            return 1;
788    }
789    return 0;
790}
791
792inline _LIBCPP_INLINE_VISIBILITY
793size_t
794char_traits<char16_t>::length(const char_type* __s)
795{
796    size_t __len = 0;
797    for (; !eq(*__s, char_type(0)); ++__s)
798        ++__len;
799    return __len;
800}
801
802inline _LIBCPP_INLINE_VISIBILITY
803const char16_t*
804char_traits<char16_t>::find(const char_type* __s, size_t __n, const char_type& __a)
805{
806    for (; __n; --__n)
807    {
808        if (eq(*__s, __a))
809            return __s;
810        ++__s;
811    }
812    return 0;
813}
814
815inline _LIBCPP_INLINE_VISIBILITY
816char16_t*
817char_traits<char16_t>::move(char_type* __s1, const char_type* __s2, size_t __n)
818{
819    char_type* __r = __s1;
820    if (__s1 < __s2)
821    {
822        for (; __n; --__n, ++__s1, ++__s2)
823            assign(*__s1, *__s2);
824    }
825    else if (__s2 < __s1)
826    {
827        __s1 += __n;
828        __s2 += __n;
829        for (; __n; --__n)
830            assign(*--__s1, *--__s2);
831    }
832    return __r;
833}
834
835inline _LIBCPP_INLINE_VISIBILITY
836char16_t*
837char_traits<char16_t>::copy(char_type* __s1, const char_type* __s2, size_t __n)
838{
839    char_type* __r = __s1;
840    for (; __n; --__n, ++__s1, ++__s2)
841        assign(*__s1, *__s2);
842    return __r;
843}
844
845inline _LIBCPP_INLINE_VISIBILITY
846char16_t*
847char_traits<char16_t>::assign(char_type* __s, size_t __n, char_type __a)
848{
849    char_type* __r = __s;
850    for (; __n; --__n, ++__s)
851        assign(*__s, __a);
852    return __r;
853}
854
855template <>
856struct _LIBCPP_TYPE_VIS char_traits<char32_t>
857{
858    typedef char32_t       char_type;
859    typedef uint_least32_t int_type;
860    typedef streamoff      off_type;
861    typedef u32streampos   pos_type;
862    typedef mbstate_t      state_type;
863
864    _LIBCPP_INLINE_VISIBILITY
865    static void assign(char_type& __c1, const char_type& __c2) _NOEXCEPT
866        {__c1 = __c2;}
867    _LIBCPP_INLINE_VISIBILITY
868    static _LIBCPP_CONSTEXPR bool eq(char_type __c1, char_type __c2) _NOEXCEPT
869        {return __c1 == __c2;}
870    _LIBCPP_INLINE_VISIBILITY
871    static _LIBCPP_CONSTEXPR bool lt(char_type __c1, char_type __c2) _NOEXCEPT
872        {return __c1 < __c2;}
873
874    static int              compare(const char_type* __s1, const char_type* __s2, size_t __n);
875    static size_t           length(const char_type* __s);
876    static const char_type* find(const char_type* __s, size_t __n, const char_type& __a);
877    static char_type*       move(char_type* __s1, const char_type* __s2, size_t __n);
878    static char_type*       copy(char_type* __s1, const char_type* __s2, size_t __n);
879    static char_type*       assign(char_type* __s, size_t __n, char_type __a);
880
881    _LIBCPP_INLINE_VISIBILITY
882    static _LIBCPP_CONSTEXPR int_type  not_eof(int_type __c) _NOEXCEPT
883        {return eq_int_type(__c, eof()) ? ~eof() : __c;}
884    _LIBCPP_INLINE_VISIBILITY
885    static _LIBCPP_CONSTEXPR char_type to_char_type(int_type __c) _NOEXCEPT
886        {return char_type(__c);}
887    _LIBCPP_INLINE_VISIBILITY
888    static _LIBCPP_CONSTEXPR int_type to_int_type(char_type __c) _NOEXCEPT
889        {return int_type(__c);}
890    _LIBCPP_INLINE_VISIBILITY
891    static _LIBCPP_CONSTEXPR bool eq_int_type(int_type __c1, int_type __c2) _NOEXCEPT
892        {return __c1 == __c2;}
893    _LIBCPP_INLINE_VISIBILITY
894    static _LIBCPP_CONSTEXPR int_type eof() _NOEXCEPT
895        {return int_type(0xFFFFFFFF);}
896};
897
898inline _LIBCPP_INLINE_VISIBILITY
899int
900char_traits<char32_t>::compare(const char_type* __s1, const char_type* __s2, size_t __n)
901{
902    for (; __n; --__n, ++__s1, ++__s2)
903    {
904        if (lt(*__s1, *__s2))
905            return -1;
906        if (lt(*__s2, *__s1))
907            return 1;
908    }
909    return 0;
910}
911
912inline _LIBCPP_INLINE_VISIBILITY
913size_t
914char_traits<char32_t>::length(const char_type* __s)
915{
916    size_t __len = 0;
917    for (; !eq(*__s, char_type(0)); ++__s)
918        ++__len;
919    return __len;
920}
921
922inline _LIBCPP_INLINE_VISIBILITY
923const char32_t*
924char_traits<char32_t>::find(const char_type* __s, size_t __n, const char_type& __a)
925{
926    for (; __n; --__n)
927    {
928        if (eq(*__s, __a))
929            return __s;
930        ++__s;
931    }
932    return 0;
933}
934
935inline _LIBCPP_INLINE_VISIBILITY
936char32_t*
937char_traits<char32_t>::move(char_type* __s1, const char_type* __s2, size_t __n)
938{
939    char_type* __r = __s1;
940    if (__s1 < __s2)
941    {
942        for (; __n; --__n, ++__s1, ++__s2)
943            assign(*__s1, *__s2);
944    }
945    else if (__s2 < __s1)
946    {
947        __s1 += __n;
948        __s2 += __n;
949        for (; __n; --__n)
950            assign(*--__s1, *--__s2);
951    }
952    return __r;
953}
954
955inline _LIBCPP_INLINE_VISIBILITY
956char32_t*
957char_traits<char32_t>::copy(char_type* __s1, const char_type* __s2, size_t __n)
958{
959    char_type* __r = __s1;
960    for (; __n; --__n, ++__s1, ++__s2)
961        assign(*__s1, *__s2);
962    return __r;
963}
964
965inline _LIBCPP_INLINE_VISIBILITY
966char32_t*
967char_traits<char32_t>::assign(char_type* __s, size_t __n, char_type __a)
968{
969    char_type* __r = __s;
970    for (; __n; --__n, ++__s)
971        assign(*__s, __a);
972    return __r;
973}
974
975#endif  // _LIBCPP_HAS_NO_UNICODE_CHARS
976
977// basic_string
978
979template<class _CharT, class _Traits, class _Allocator>
980basic_string<_CharT, _Traits, _Allocator>
981operator+(const basic_string<_CharT, _Traits, _Allocator>& __x,
982          const basic_string<_CharT, _Traits, _Allocator>& __y);
983
984template<class _CharT, class _Traits, class _Allocator>
985basic_string<_CharT, _Traits, _Allocator>
986operator+(const _CharT* __x, const basic_string<_CharT,_Traits,_Allocator>& __y);
987
988template<class _CharT, class _Traits, class _Allocator>
989basic_string<_CharT, _Traits, _Allocator>
990operator+(_CharT __x, const basic_string<_CharT,_Traits,_Allocator>& __y);
991
992template<class _CharT, class _Traits, class _Allocator>
993basic_string<_CharT, _Traits, _Allocator>
994operator+(const basic_string<_CharT, _Traits, _Allocator>& __x, const _CharT* __y);
995
996template<class _CharT, class _Traits, class _Allocator>
997basic_string<_CharT, _Traits, _Allocator>
998operator+(const basic_string<_CharT, _Traits, _Allocator>& __x, _CharT __y);
999
1000template <bool>
1001class __basic_string_common
1002{
1003protected:
1004    void __throw_length_error() const;
1005    void __throw_out_of_range() const;
1006};
1007
1008template <bool __b>
1009void
1010__basic_string_common<__b>::__throw_length_error() const
1011{
1012#ifndef _LIBCPP_NO_EXCEPTIONS
1013    throw length_error("basic_string");
1014#else
1015    assert(!"basic_string length_error");
1016#endif
1017}
1018
1019template <bool __b>
1020void
1021__basic_string_common<__b>::__throw_out_of_range() const
1022{
1023#ifndef _LIBCPP_NO_EXCEPTIONS
1024    throw out_of_range("basic_string");
1025#else
1026    assert(!"basic_string out_of_range");
1027#endif
1028}
1029
1030#ifdef _MSC_VER
1031#pragma warning( push )
1032#pragma warning( disable: 4231 )
1033#endif // _MSC_VER
1034_LIBCPP_EXTERN_TEMPLATE(class __basic_string_common<true>)
1035#ifdef _MSC_VER
1036#pragma warning( pop )
1037#endif // _MSC_VER
1038
1039template<class _CharT, class _Traits, class _Allocator>
1040class _LIBCPP_TYPE_VIS basic_string
1041    : private __basic_string_common<true>
1042{
1043public:
1044    typedef basic_string                                 __self;
1045    typedef _Traits                                      traits_type;
1046    typedef typename traits_type::char_type              value_type;
1047    typedef _Allocator                                   allocator_type;
1048    typedef allocator_traits<allocator_type>             __alloc_traits;
1049    typedef typename __alloc_traits::size_type           size_type;
1050    typedef typename __alloc_traits::difference_type     difference_type;
1051    typedef value_type&                                  reference;
1052    typedef const value_type&                            const_reference;
1053    typedef typename __alloc_traits::pointer             pointer;
1054    typedef typename __alloc_traits::const_pointer       const_pointer;
1055#ifdef _LIBCPP_DEBUG
1056    typedef __debug_iter<basic_string, pointer>          iterator;
1057    typedef __debug_iter<basic_string, const_pointer>    const_iterator;
1058
1059    friend class __debug_iter<basic_string, pointer>;
1060    friend class __debug_iter<basic_string, const_pointer>;
1061#elif defined(_LIBCPP_RAW_ITERATORS)
1062    typedef pointer                                      iterator;
1063    typedef const_pointer                                const_iterator;
1064#else  // defined(_LIBCPP_RAW_ITERATORS)
1065    typedef __wrap_iter<pointer>                         iterator;
1066    typedef __wrap_iter<const_pointer>                   const_iterator;
1067#endif  // defined(_LIBCPP_RAW_ITERATORS)
1068    typedef _VSTD::reverse_iterator<iterator>             reverse_iterator;
1069    typedef _VSTD::reverse_iterator<const_iterator>       const_reverse_iterator;
1070
1071private:
1072    struct __long
1073    {
1074        size_type __cap_;
1075        size_type __size_;
1076        pointer   __data_;
1077    };
1078
1079#if _LIBCPP_BIG_ENDIAN
1080    enum {__short_mask = 0x80};
1081    enum {__long_mask  = ~(size_type(~0) >> 1)};
1082#else  // _LIBCPP_BIG_ENDIAN
1083    enum {__short_mask = 0x01};
1084    enum {__long_mask  = 0x1ul};
1085#endif  // _LIBCPP_BIG_ENDIAN
1086
1087    enum {__mask = size_type(~0) >> 1};
1088
1089    enum {__min_cap = (sizeof(__long) - 1)/sizeof(value_type) > 2 ?
1090                      (sizeof(__long) - 1)/sizeof(value_type) : 2};
1091
1092    struct __short
1093    {
1094        union
1095        {
1096            unsigned char __size_;
1097            value_type __lx;
1098        };
1099        value_type __data_[__min_cap];
1100    };
1101
1102    union __lx{__long __lx; __short __lxx;};
1103
1104    enum {__n_words = sizeof(__lx) / sizeof(size_type)};
1105
1106    struct __raw
1107    {
1108        size_type __words[__n_words];
1109    };
1110
1111    struct __rep
1112    {
1113        union
1114        {
1115            __long  __l;
1116            __short __s;
1117            __raw   __r;
1118        };
1119    };
1120
1121    __compressed_pair<__rep, allocator_type> __r_;
1122
1123#ifdef _LIBCPP_DEBUG
1124
1125    pair<iterator*, const_iterator*> __iterator_list_;
1126
1127    _LIBCPP_INLINE_VISIBILITY iterator*&       __get_iterator_list(iterator*)       {return __iterator_list_.first;}
1128    _LIBCPP_INLINE_VISIBILITY const_iterator*& __get_iterator_list(const_iterator*) {return __iterator_list_.second;}
1129
1130#endif  // _LIBCPP_DEBUG
1131
1132public:
1133    static const size_type npos = -1;
1134
1135    _LIBCPP_INLINE_VISIBILITY basic_string()
1136        _NOEXCEPT_(is_nothrow_default_constructible<allocator_type>::value);
1137    _LIBCPP_INLINE_VISIBILITY explicit basic_string(const allocator_type& __a);
1138    basic_string(const basic_string& __str);
1139    basic_string(const basic_string& __str, const allocator_type& __a);
1140#ifndef _LIBCPP_HAS_NO_RVALUE_REFERENCES
1141    _LIBCPP_INLINE_VISIBILITY
1142    basic_string(basic_string&& __str)
1143        _NOEXCEPT_(is_nothrow_move_constructible<allocator_type>::value);
1144    _LIBCPP_INLINE_VISIBILITY
1145    basic_string(basic_string&& __str, const allocator_type& __a);
1146#endif  // _LIBCPP_HAS_NO_RVALUE_REFERENCES
1147    _LIBCPP_INLINE_VISIBILITY basic_string(const_pointer __s);
1148    _LIBCPP_INLINE_VISIBILITY
1149    basic_string(const_pointer __s, const allocator_type& __a);
1150    _LIBCPP_INLINE_VISIBILITY
1151    basic_string(const_pointer __s, size_type __n);
1152    _LIBCPP_INLINE_VISIBILITY
1153    basic_string(const_pointer __s, size_type __n, const allocator_type& __a);
1154    _LIBCPP_INLINE_VISIBILITY
1155    basic_string(size_type __n, value_type __c);
1156    _LIBCPP_INLINE_VISIBILITY
1157    basic_string(size_type __n, value_type __c, const allocator_type& __a);
1158    basic_string(const basic_string& __str, size_type __pos, size_type __n = npos,
1159                 const allocator_type& __a = allocator_type());
1160    template<class _InputIterator>
1161        _LIBCPP_INLINE_VISIBILITY
1162        basic_string(_InputIterator __first, _InputIterator __last);
1163    template<class _InputIterator>
1164        _LIBCPP_INLINE_VISIBILITY
1165        basic_string(_InputIterator __first, _InputIterator __last, const allocator_type& __a);
1166#ifndef _LIBCPP_HAS_NO_GENERALIZED_INITIALIZERS
1167    _LIBCPP_INLINE_VISIBILITY
1168    basic_string(initializer_list<value_type> __il);
1169    _LIBCPP_INLINE_VISIBILITY
1170    basic_string(initializer_list<value_type> __il, const allocator_type& __a);
1171#endif  // _LIBCPP_HAS_NO_GENERALIZED_INITIALIZERS
1172
1173    ~basic_string();
1174
1175    basic_string& operator=(const basic_string& __str);
1176#ifndef _LIBCPP_HAS_NO_RVALUE_REFERENCES
1177    _LIBCPP_INLINE_VISIBILITY
1178    basic_string& operator=(basic_string&& __str)
1179        _NOEXCEPT_(__alloc_traits::propagate_on_container_move_assignment::value &&
1180                   is_nothrow_move_assignable<allocator_type>::value);
1181#endif
1182    _LIBCPP_INLINE_VISIBILITY basic_string& operator=(const_pointer __s) {return assign(__s);}
1183    basic_string& operator=(value_type __c);
1184#ifndef _LIBCPP_HAS_NO_GENERALIZED_INITIALIZERS
1185    _LIBCPP_INLINE_VISIBILITY
1186    basic_string& operator=(initializer_list<value_type> __il) {return assign(__il.begin(), __il.size());}
1187#endif  // _LIBCPP_HAS_NO_GENERALIZED_INITIALIZERS
1188
1189#ifndef _LIBCPP_DEBUG
1190    _LIBCPP_INLINE_VISIBILITY
1191    iterator begin() _NOEXCEPT
1192        {return iterator(__get_pointer());}
1193    _LIBCPP_INLINE_VISIBILITY
1194    const_iterator begin() const _NOEXCEPT
1195        {return const_iterator(data());}
1196    _LIBCPP_INLINE_VISIBILITY
1197    iterator end() _NOEXCEPT
1198        {return iterator(__get_pointer() + size());}
1199    _LIBCPP_INLINE_VISIBILITY
1200    const_iterator end() const _NOEXCEPT
1201        {return const_iterator(data() + size());}
1202#else  // _LIBCPP_DEBUG
1203    _LIBCPP_INLINE_VISIBILITY iterator       begin()       {return iterator(this, __get_pointer());}
1204    _LIBCPP_INLINE_VISIBILITY const_iterator begin() const {return const_iterator(this, data());}
1205    _LIBCPP_INLINE_VISIBILITY iterator       end()         {return iterator(this, __get_pointer() + size());}
1206    _LIBCPP_INLINE_VISIBILITY const_iterator end() const   {return const_iterator(this, data() + size());}
1207#endif  // _LIBCPP_DEBUG
1208    _LIBCPP_INLINE_VISIBILITY
1209    reverse_iterator rbegin() _NOEXCEPT
1210        {return reverse_iterator(end());}
1211    _LIBCPP_INLINE_VISIBILITY
1212    const_reverse_iterator rbegin() const _NOEXCEPT
1213        {return const_reverse_iterator(end());}
1214    _LIBCPP_INLINE_VISIBILITY
1215    reverse_iterator rend() _NOEXCEPT
1216        {return reverse_iterator(begin());}
1217    _LIBCPP_INLINE_VISIBILITY
1218    const_reverse_iterator rend() const _NOEXCEPT
1219        {return const_reverse_iterator(begin());}
1220
1221    _LIBCPP_INLINE_VISIBILITY
1222    const_iterator cbegin() const _NOEXCEPT
1223        {return begin();}
1224    _LIBCPP_INLINE_VISIBILITY
1225    const_iterator cend() const _NOEXCEPT
1226        {return end();}
1227    _LIBCPP_INLINE_VISIBILITY
1228    const_reverse_iterator crbegin() const _NOEXCEPT
1229        {return rbegin();}
1230    _LIBCPP_INLINE_VISIBILITY
1231    const_reverse_iterator crend() const _NOEXCEPT
1232        {return rend();}
1233
1234    _LIBCPP_INLINE_VISIBILITY size_type size() const _NOEXCEPT
1235        {return __is_long() ? __get_long_size() : __get_short_size();}
1236    _LIBCPP_INLINE_VISIBILITY size_type length() const _NOEXCEPT {return size();}
1237    _LIBCPP_INLINE_VISIBILITY size_type max_size() const _NOEXCEPT;
1238    _LIBCPP_INLINE_VISIBILITY size_type capacity() const _NOEXCEPT
1239        {return (__is_long() ? __get_long_cap() : __min_cap) - 1;}
1240
1241    void resize(size_type __n, value_type __c);
1242    _LIBCPP_INLINE_VISIBILITY void resize(size_type __n) {resize(__n, value_type());}
1243
1244    void reserve(size_type res_arg = 0);
1245    _LIBCPP_INLINE_VISIBILITY
1246    void shrink_to_fit() _NOEXCEPT {reserve();}
1247    _LIBCPP_INLINE_VISIBILITY
1248    void clear() _NOEXCEPT;
1249    _LIBCPP_INLINE_VISIBILITY bool empty() const _NOEXCEPT {return size() == 0;}
1250
1251    _LIBCPP_INLINE_VISIBILITY const_reference operator[](size_type __pos) const;
1252    _LIBCPP_INLINE_VISIBILITY reference       operator[](size_type __pos);
1253
1254    const_reference at(size_type __n) const;
1255    reference       at(size_type __n);
1256
1257    _LIBCPP_INLINE_VISIBILITY basic_string& operator+=(const basic_string& __str) {return append(__str);}
1258    _LIBCPP_INLINE_VISIBILITY basic_string& operator+=(const_pointer __s)         {return append(__s);}
1259    _LIBCPP_INLINE_VISIBILITY basic_string& operator+=(value_type __c)            {push_back(__c); return *this;}
1260#ifndef _LIBCPP_HAS_NO_GENERALIZED_INITIALIZERS
1261    _LIBCPP_INLINE_VISIBILITY basic_string& operator+=(initializer_list<value_type> __il) {return append(__il);}
1262#endif  // _LIBCPP_HAS_NO_GENERALIZED_INITIALIZERS
1263
1264    _LIBCPP_INLINE_VISIBILITY
1265    basic_string& append(const basic_string& __str);
1266    basic_string& append(const basic_string& __str, size_type __pos, size_type __n);
1267    basic_string& append(const_pointer __s, size_type __n);
1268    basic_string& append(const_pointer __s);
1269    basic_string& append(size_type __n, value_type __c);
1270    template<class _InputIterator>
1271        typename enable_if
1272        <
1273             __is_input_iterator  <_InputIterator>::value &&
1274            !__is_forward_iterator<_InputIterator>::value,
1275            basic_string&
1276        >::type
1277        append(_InputIterator __first, _InputIterator __last);
1278    template<class _ForwardIterator>
1279        typename enable_if
1280        <
1281            __is_forward_iterator<_ForwardIterator>::value,
1282            basic_string&
1283        >::type
1284        append(_ForwardIterator __first, _ForwardIterator __last);
1285#ifndef _LIBCPP_HAS_NO_GENERALIZED_INITIALIZERS
1286    _LIBCPP_INLINE_VISIBILITY
1287    basic_string& append(initializer_list<value_type> __il) {return append(__il.begin(), __il.size());}
1288#endif  // _LIBCPP_HAS_NO_GENERALIZED_INITIALIZERS
1289
1290    void push_back(value_type __c);
1291    _LIBCPP_INLINE_VISIBILITY
1292    void pop_back();
1293    _LIBCPP_INLINE_VISIBILITY reference       front();
1294    _LIBCPP_INLINE_VISIBILITY const_reference front() const;
1295    _LIBCPP_INLINE_VISIBILITY reference       back();
1296    _LIBCPP_INLINE_VISIBILITY const_reference back() const;
1297
1298    _LIBCPP_INLINE_VISIBILITY
1299    basic_string& assign(const basic_string& __str);
1300#ifndef _LIBCPP_HAS_NO_RVALUE_REFERENCES
1301    _LIBCPP_INLINE_VISIBILITY
1302    basic_string& assign(basic_string&& str)
1303        {*this = _VSTD::move(str); return *this;}
1304#endif
1305    basic_string& assign(const basic_string& __str, size_type __pos, size_type __n);
1306    basic_string& assign(const_pointer __s, size_type __n);
1307    basic_string& assign(const_pointer __s);
1308    basic_string& assign(size_type __n, value_type __c);
1309    template<class _InputIterator>
1310        typename enable_if
1311        <
1312             __is_input_iterator  <_InputIterator>::value &&
1313            !__is_forward_iterator<_InputIterator>::value,
1314            basic_string&
1315        >::type
1316        assign(_InputIterator __first, _InputIterator __last);
1317    template<class _ForwardIterator>
1318        typename enable_if
1319        <
1320            __is_forward_iterator<_ForwardIterator>::value,
1321            basic_string&
1322        >::type
1323        assign(_ForwardIterator __first, _ForwardIterator __last);
1324#ifndef _LIBCPP_HAS_NO_GENERALIZED_INITIALIZERS
1325    _LIBCPP_INLINE_VISIBILITY
1326    basic_string& assign(initializer_list<value_type> __il) {return assign(__il.begin(), __il.size());}
1327#endif  // _LIBCPP_HAS_NO_GENERALIZED_INITIALIZERS
1328
1329    _LIBCPP_INLINE_VISIBILITY
1330    basic_string& insert(size_type __pos1, const basic_string& __str);
1331    basic_string& insert(size_type __pos1, const basic_string& __str, size_type __pos2, size_type __n);
1332    basic_string& insert(size_type __pos, const_pointer __s, size_type __n);
1333    basic_string& insert(size_type __pos, const_pointer __s);
1334    basic_string& insert(size_type __pos, size_type __n, value_type __c);
1335    iterator      insert(const_iterator __pos, value_type __c);
1336    _LIBCPP_INLINE_VISIBILITY
1337    iterator      insert(const_iterator __pos, size_type __n, value_type __c);
1338    template<class _InputIterator>
1339        typename enable_if
1340        <
1341             __is_input_iterator  <_InputIterator>::value &&
1342            !__is_forward_iterator<_InputIterator>::value,
1343            iterator
1344        >::type
1345        insert(const_iterator __pos, _InputIterator __first, _InputIterator __last);
1346    template<class _ForwardIterator>
1347        typename enable_if
1348        <
1349            __is_forward_iterator<_ForwardIterator>::value,
1350            iterator
1351        >::type
1352        insert(const_iterator __pos, _ForwardIterator __first, _ForwardIterator __last);
1353#ifndef _LIBCPP_HAS_NO_GENERALIZED_INITIALIZERS
1354    _LIBCPP_INLINE_VISIBILITY
1355    iterator insert(const_iterator __pos, initializer_list<value_type> __il)
1356                    {return insert(__pos, __il.begin(), __il.end());}
1357#endif  // _LIBCPP_HAS_NO_GENERALIZED_INITIALIZERS
1358
1359    basic_string& erase(size_type __pos = 0, size_type __n = npos);
1360    _LIBCPP_INLINE_VISIBILITY
1361    iterator      erase(const_iterator __pos);
1362    _LIBCPP_INLINE_VISIBILITY
1363    iterator      erase(const_iterator __first, const_iterator __last);
1364
1365    _LIBCPP_INLINE_VISIBILITY
1366    basic_string& replace(size_type __pos1, size_type __n1, const basic_string& __str);
1367    basic_string& replace(size_type __pos1, size_type __n1, const basic_string& __str, size_type __pos2, size_type __n2);
1368    basic_string& replace(size_type __pos, size_type __n1, const_pointer __s, size_type __n2);
1369    basic_string& replace(size_type __pos, size_type __n1, const_pointer __s);
1370    basic_string& replace(size_type __pos, size_type __n1, size_type __n2, value_type __c);
1371    _LIBCPP_INLINE_VISIBILITY
1372    basic_string& replace(const_iterator __i1, const_iterator __i2, const basic_string& __str);
1373    _LIBCPP_INLINE_VISIBILITY
1374    basic_string& replace(const_iterator __i1, const_iterator __i2, const_pointer __s, size_type __n);
1375    _LIBCPP_INLINE_VISIBILITY
1376    basic_string& replace(const_iterator __i1, const_iterator __i2, const_pointer __s);
1377    _LIBCPP_INLINE_VISIBILITY
1378    basic_string& replace(const_iterator __i1, const_iterator __i2, size_type __n, value_type __c);
1379    template<class _InputIterator>
1380        typename enable_if
1381        <
1382            __is_input_iterator<_InputIterator>::value,
1383            basic_string&
1384        >::type
1385        replace(const_iterator __i1, const_iterator __i2, _InputIterator __j1, _InputIterator __j2);
1386#ifndef _LIBCPP_HAS_NO_GENERALIZED_INITIALIZERS
1387    _LIBCPP_INLINE_VISIBILITY
1388    basic_string& replace(const_iterator __i1, const_iterator __i2, initializer_list<value_type> __il)
1389        {return replace(__i1, __i2, __il.begin(), __il.end());}
1390#endif  // _LIBCPP_HAS_NO_GENERALIZED_INITIALIZERS
1391
1392    size_type copy(pointer __s, size_type __n, size_type __pos = 0) const;
1393    _LIBCPP_INLINE_VISIBILITY
1394    basic_string substr(size_type __pos = 0, size_type __n = npos) const;
1395
1396    _LIBCPP_INLINE_VISIBILITY
1397    void swap(basic_string& __str)
1398        _NOEXCEPT_(!__alloc_traits::propagate_on_container_swap::value ||
1399                   __is_nothrow_swappable<allocator_type>::value);
1400
1401    _LIBCPP_INLINE_VISIBILITY
1402    const_pointer c_str() const _NOEXCEPT {return data();}
1403    _LIBCPP_INLINE_VISIBILITY
1404    const_pointer data() const _NOEXCEPT  {return __get_pointer();}
1405
1406    _LIBCPP_INLINE_VISIBILITY
1407    allocator_type get_allocator() const _NOEXCEPT {return __alloc();}
1408
1409    _LIBCPP_INLINE_VISIBILITY
1410    size_type find(const basic_string& __str, size_type __pos = 0) const _NOEXCEPT;
1411    size_type find(const_pointer __s, size_type __pos, size_type __n) const _NOEXCEPT;
1412    _LIBCPP_INLINE_VISIBILITY
1413    size_type find(const_pointer __s, size_type __pos = 0) const _NOEXCEPT;
1414    size_type find(value_type __c, size_type __pos = 0) const _NOEXCEPT;
1415
1416    _LIBCPP_INLINE_VISIBILITY
1417    size_type rfind(const basic_string& __str, size_type __pos = npos) const _NOEXCEPT;
1418    size_type rfind(const_pointer __s, size_type __pos, size_type __n) const _NOEXCEPT;
1419    _LIBCPP_INLINE_VISIBILITY
1420    size_type rfind(const_pointer __s, size_type __pos = npos) const _NOEXCEPT;
1421    size_type rfind(value_type __c, size_type __pos = npos) const _NOEXCEPT;
1422
1423    _LIBCPP_INLINE_VISIBILITY
1424    size_type find_first_of(const basic_string& __str, size_type __pos = 0) const _NOEXCEPT;
1425    size_type find_first_of(const_pointer __s, size_type __pos, size_type __n) const _NOEXCEPT;
1426    _LIBCPP_INLINE_VISIBILITY
1427    size_type find_first_of(const_pointer __s, size_type __pos = 0) const _NOEXCEPT;
1428    _LIBCPP_INLINE_VISIBILITY
1429    size_type find_first_of(value_type __c, size_type __pos = 0) const _NOEXCEPT;
1430
1431    _LIBCPP_INLINE_VISIBILITY
1432    size_type find_last_of(const basic_string& __str, size_type __pos = npos) const _NOEXCEPT;
1433    size_type find_last_of(const_pointer __s, size_type __pos, size_type __n) const _NOEXCEPT;
1434    _LIBCPP_INLINE_VISIBILITY
1435    size_type find_last_of(const_pointer __s, size_type __pos = npos) const _NOEXCEPT;
1436    _LIBCPP_INLINE_VISIBILITY
1437    size_type find_last_of(value_type __c, size_type __pos = npos) const _NOEXCEPT;
1438
1439    _LIBCPP_INLINE_VISIBILITY
1440    size_type find_first_not_of(const basic_string& __str, size_type __pos = 0) const _NOEXCEPT;
1441    size_type find_first_not_of(const_pointer __s, size_type __pos, size_type __n) const _NOEXCEPT;
1442    _LIBCPP_INLINE_VISIBILITY
1443    size_type find_first_not_of(const_pointer __s, size_type __pos = 0) const _NOEXCEPT;
1444    _LIBCPP_INLINE_VISIBILITY
1445    size_type find_first_not_of(value_type __c, size_type __pos = 0) const _NOEXCEPT;
1446
1447    _LIBCPP_INLINE_VISIBILITY
1448    size_type find_last_not_of(const basic_string& __str, size_type __pos = npos) const _NOEXCEPT;
1449    size_type find_last_not_of(const_pointer __s, size_type __pos, size_type __n) const _NOEXCEPT;
1450    _LIBCPP_INLINE_VISIBILITY
1451    size_type find_last_not_of(const_pointer __s, size_type __pos = npos) const _NOEXCEPT;
1452    _LIBCPP_INLINE_VISIBILITY
1453    size_type find_last_not_of(value_type __c, size_type __pos = npos) const _NOEXCEPT;
1454
1455    _LIBCPP_INLINE_VISIBILITY
1456    int compare(const basic_string& __str) const _NOEXCEPT;
1457    _LIBCPP_INLINE_VISIBILITY
1458    int compare(size_type __pos1, size_type __n1, const basic_string& __str) const;
1459    int compare(size_type __pos1, size_type __n1, const basic_string& __str, size_type __pos2, size_type __n2) const;
1460    int compare(const_pointer __s) const _NOEXCEPT;
1461    int compare(size_type __pos1, size_type __n1, const_pointer __s) const;
1462    int compare(size_type __pos1, size_type __n1, const_pointer __s, size_type __n2) const;
1463
1464    _LIBCPP_INLINE_VISIBILITY bool __invariants() const;
1465
1466    _LIBCPP_INLINE_VISIBILITY
1467    bool __is_long() const _NOEXCEPT
1468        {return bool(__r_.first().__s.__size_ & __short_mask);}
1469
1470private:
1471    _LIBCPP_INLINE_VISIBILITY
1472    allocator_type& __alloc() _NOEXCEPT
1473        {return __r_.second();}
1474    _LIBCPP_INLINE_VISIBILITY
1475    const allocator_type& __alloc() const _NOEXCEPT
1476        {return __r_.second();}
1477
1478    _LIBCPP_INLINE_VISIBILITY
1479    void __set_short_size(size_type __s) _NOEXCEPT
1480#if _LIBCPP_BIG_ENDIAN
1481        {__r_.first().__s.__size_ = (unsigned char)(__s);}
1482#else
1483        {__r_.first().__s.__size_ = (unsigned char)(__s << 1);}
1484#endif
1485    _LIBCPP_INLINE_VISIBILITY
1486    size_type __get_short_size() const _NOEXCEPT
1487#if _LIBCPP_BIG_ENDIAN
1488        {return __r_.first().__s.__size_;}
1489#else
1490        {return __r_.first().__s.__size_ >> 1;}
1491#endif
1492    _LIBCPP_INLINE_VISIBILITY
1493    void __set_long_size(size_type __s) _NOEXCEPT
1494        {__r_.first().__l.__size_ = __s;}
1495    _LIBCPP_INLINE_VISIBILITY
1496    size_type __get_long_size() const _NOEXCEPT
1497        {return __r_.first().__l.__size_;}
1498    _LIBCPP_INLINE_VISIBILITY
1499    void __set_size(size_type __s) _NOEXCEPT
1500        {if (__is_long()) __set_long_size(__s); else __set_short_size(__s);}
1501
1502    _LIBCPP_INLINE_VISIBILITY
1503    void __set_long_cap(size_type __s) _NOEXCEPT
1504        {__r_.first().__l.__cap_  = __long_mask | __s;}
1505    _LIBCPP_INLINE_VISIBILITY
1506    size_type __get_long_cap() const _NOEXCEPT
1507        {return __r_.first().__l.__cap_ & size_type(~__long_mask);}
1508
1509    _LIBCPP_INLINE_VISIBILITY
1510    void __set_long_pointer(pointer __p) _NOEXCEPT
1511        {__r_.first().__l.__data_ = __p;}
1512    _LIBCPP_INLINE_VISIBILITY
1513    pointer __get_long_pointer() _NOEXCEPT
1514        {return __r_.first().__l.__data_;}
1515    _LIBCPP_INLINE_VISIBILITY
1516    const_pointer __get_long_pointer() const _NOEXCEPT
1517        {return __r_.first().__l.__data_;}
1518    _LIBCPP_INLINE_VISIBILITY
1519    pointer __get_short_pointer() _NOEXCEPT
1520        {return __r_.first().__s.__data_;}
1521    _LIBCPP_INLINE_VISIBILITY
1522    const_pointer __get_short_pointer() const _NOEXCEPT
1523        {return __r_.first().__s.__data_;}
1524    _LIBCPP_INLINE_VISIBILITY
1525    pointer __get_pointer() _NOEXCEPT
1526        {return __is_long() ? __get_long_pointer() : __get_short_pointer();}
1527    _LIBCPP_INLINE_VISIBILITY
1528    const_pointer __get_pointer() const _NOEXCEPT
1529        {return __is_long() ? __get_long_pointer() : __get_short_pointer();}
1530
1531    _LIBCPP_INLINE_VISIBILITY
1532    void __zero() _NOEXCEPT
1533        {
1534            size_type (&__a)[__n_words] = __r_.first().__r.__words;
1535            for (unsigned __i = 0; __i < __n_words; ++__i)
1536                __a[__i] = 0;
1537        }
1538
1539    template <size_type __a> static
1540        _LIBCPP_INLINE_VISIBILITY
1541        size_type __align(size_type __s) _NOEXCEPT
1542            {return __s + (__a-1) & ~(__a-1);}
1543    enum {__alignment = 16};
1544    static _LIBCPP_INLINE_VISIBILITY
1545    size_type __recommend(size_type __s) _NOEXCEPT
1546        {return (__s < __min_cap ? __min_cap :
1547                 __align<sizeof(value_type) < __alignment ?
1548                            __alignment/sizeof(value_type) : 1 > (__s+1)) - 1;}
1549
1550    void __init(const_pointer __s, size_type __sz, size_type __reserve);
1551    void __init(const_pointer __s, size_type __sz);
1552    void __init(size_type __n, value_type __c);
1553
1554    template <class _InputIterator>
1555    typename enable_if
1556    <
1557         __is_input_iterator  <_InputIterator>::value &&
1558        !__is_forward_iterator<_InputIterator>::value,
1559        void
1560    >::type
1561    __init(_InputIterator __first, _InputIterator __last);
1562
1563    template <class _ForwardIterator>
1564    typename enable_if
1565    <
1566        __is_forward_iterator<_ForwardIterator>::value,
1567        void
1568    >::type
1569    __init(_ForwardIterator __first, _ForwardIterator __last);
1570
1571    void __grow_by(size_type __old_cap, size_type __delta_cap, size_type __old_sz,
1572                   size_type __n_copy,  size_type __n_del,     size_type __n_add = 0);
1573    void __grow_by_and_replace(size_type __old_cap, size_type __delta_cap, size_type __old_sz,
1574                               size_type __n_copy,  size_type __n_del,
1575                               size_type __n_add, const_pointer __p_new_stuff);
1576
1577    _LIBCPP_INLINE_VISIBILITY
1578    void __erase_to_end(size_type __pos);
1579
1580    _LIBCPP_INLINE_VISIBILITY
1581    void __copy_assign_alloc(const basic_string& __str)
1582        {__copy_assign_alloc(__str, integral_constant<bool,
1583                      __alloc_traits::propagate_on_container_copy_assignment::value>());}
1584
1585    _LIBCPP_INLINE_VISIBILITY
1586    void __copy_assign_alloc(const basic_string& __str, true_type)
1587        {
1588            if (__alloc() != __str.__alloc())
1589            {
1590                clear();
1591                shrink_to_fit();
1592            }
1593            __alloc() = __str.__alloc();
1594        }
1595
1596    _LIBCPP_INLINE_VISIBILITY
1597    void __copy_assign_alloc(const basic_string&, false_type) _NOEXCEPT
1598        {}
1599
1600#ifndef _LIBCPP_HAS_NO_RVALUE_REFERENCES
1601    _LIBCPP_INLINE_VISIBILITY
1602    void __move_assign(basic_string& __str, false_type);
1603    _LIBCPP_INLINE_VISIBILITY
1604    void __move_assign(basic_string& __str, true_type)
1605        _NOEXCEPT_(is_nothrow_move_assignable<allocator_type>::value);
1606#endif
1607
1608    _LIBCPP_INLINE_VISIBILITY
1609    void
1610    __move_assign_alloc(basic_string& __str)
1611        _NOEXCEPT_(
1612            !__alloc_traits::propagate_on_container_move_assignment::value ||
1613            is_nothrow_move_assignable<allocator_type>::value)
1614    {__move_assign_alloc(__str, integral_constant<bool,
1615                      __alloc_traits::propagate_on_container_move_assignment::value>());}
1616
1617    _LIBCPP_INLINE_VISIBILITY
1618    void __move_assign_alloc(basic_string& __c, true_type)
1619        _NOEXCEPT_(is_nothrow_move_assignable<allocator_type>::value)
1620        {
1621            __alloc() = _VSTD::move(__c.__alloc());
1622        }
1623
1624    _LIBCPP_INLINE_VISIBILITY
1625    void __move_assign_alloc(basic_string&, false_type)
1626        _NOEXCEPT
1627        {}
1628
1629    _LIBCPP_INLINE_VISIBILITY
1630    static void __swap_alloc(allocator_type& __x, allocator_type& __y)
1631        _NOEXCEPT_(!__alloc_traits::propagate_on_container_swap::value ||
1632                   __is_nothrow_swappable<allocator_type>::value)
1633        {__swap_alloc(__x, __y, integral_constant<bool,
1634                      __alloc_traits::propagate_on_container_swap::value>());}
1635
1636    _LIBCPP_INLINE_VISIBILITY
1637    static void __swap_alloc(allocator_type& __x, allocator_type& __y, true_type)
1638        _NOEXCEPT_(__is_nothrow_swappable<allocator_type>::value)
1639        {
1640            using _VSTD::swap;
1641            swap(__x, __y);
1642        }
1643    _LIBCPP_INLINE_VISIBILITY
1644    static void __swap_alloc(allocator_type&, allocator_type&, false_type) _NOEXCEPT
1645        {}
1646
1647    _LIBCPP_INLINE_VISIBILITY void __invalidate_all_iterators();
1648    _LIBCPP_INLINE_VISIBILITY void __invalidate_iterators_past(size_type);
1649
1650    friend basic_string operator+<>(const basic_string&, const basic_string&);
1651    friend basic_string operator+<>(const value_type*, const basic_string&);
1652    friend basic_string operator+<>(value_type, const basic_string&);
1653    friend basic_string operator+<>(const basic_string&, const value_type*);
1654    friend basic_string operator+<>(const basic_string&, value_type);
1655};
1656
1657template <class _CharT, class _Traits, class _Allocator>
1658#ifndef _LIBCPP_DEBUG
1659_LIBCPP_INLINE_VISIBILITY inline
1660#endif
1661void
1662basic_string<_CharT, _Traits, _Allocator>::__invalidate_all_iterators()
1663{
1664#ifdef _LIBCPP_DEBUG
1665    iterator::__remove_all(this);
1666    const_iterator::__remove_all(this);
1667#endif  // _LIBCPP_DEBUG
1668}
1669
1670template <class _CharT, class _Traits, class _Allocator>
1671#ifndef _LIBCPP_DEBUG
1672_LIBCPP_INLINE_VISIBILITY inline
1673#endif
1674void
1675basic_string<_CharT, _Traits, _Allocator>::__invalidate_iterators_past(size_type
1676#ifdef _LIBCPP_DEBUG
1677                                                                        __pos
1678#endif
1679                                                                      )
1680{
1681#ifdef _LIBCPP_DEBUG
1682    const_iterator __beg = begin();
1683    if (__iterator_list_.first)
1684    {
1685        for (iterator* __p = __iterator_list_.first; __p;)
1686        {
1687            if (*__p - __beg > static_cast<difference_type>(__pos))
1688            {
1689                iterator* __n = __p;
1690                __p = __p->__next;
1691                __n->__remove_owner();
1692            }
1693            else
1694                __p = __p->__next;
1695        }
1696    }
1697    if (__iterator_list_.second)
1698    {
1699        for (const_iterator* __p = __iterator_list_.second; __p;)
1700        {
1701            if (*__p - __beg > static_cast<difference_type>(__pos))
1702            {
1703                const_iterator* __n = __p;
1704                __p = __p->__next;
1705                __n->__remove_owner();
1706            }
1707            else
1708                __p = __p->__next;
1709        }
1710    }
1711#endif  // _LIBCPP_DEBUG
1712}
1713
1714template <class _CharT, class _Traits, class _Allocator>
1715_LIBCPP_INLINE_VISIBILITY inline
1716basic_string<_CharT, _Traits, _Allocator>::basic_string()
1717    _NOEXCEPT_(is_nothrow_default_constructible<allocator_type>::value)
1718{
1719    __zero();
1720}
1721
1722template <class _CharT, class _Traits, class _Allocator>
1723_LIBCPP_INLINE_VISIBILITY inline
1724basic_string<_CharT, _Traits, _Allocator>::basic_string(const allocator_type& __a)
1725    : __r_(__a)
1726{
1727    __zero();
1728}
1729
1730template <class _CharT, class _Traits, class _Allocator>
1731void
1732basic_string<_CharT, _Traits, _Allocator>::__init(const_pointer __s, size_type __sz, size_type __reserve)
1733{
1734    if (__reserve > max_size())
1735        this->__throw_length_error();
1736    pointer __p;
1737    if (__reserve < __min_cap)
1738    {
1739        __set_short_size(__sz);
1740        __p = __get_short_pointer();
1741    }
1742    else
1743    {
1744        size_type __cap = __recommend(__reserve);
1745        __p = __alloc_traits::allocate(__alloc(), __cap+1);
1746        __set_long_pointer(__p);
1747        __set_long_cap(__cap+1);
1748        __set_long_size(__sz);
1749    }
1750    traits_type::copy(__p, __s, __sz);
1751    traits_type::assign(__p[__sz], value_type());
1752}
1753
1754template <class _CharT, class _Traits, class _Allocator>
1755void
1756basic_string<_CharT, _Traits, _Allocator>::__init(const_pointer __s, size_type __sz)
1757{
1758    if (__sz > max_size())
1759        this->__throw_length_error();
1760    pointer __p;
1761    if (__sz < __min_cap)
1762    {
1763        __set_short_size(__sz);
1764        __p = __get_short_pointer();
1765    }
1766    else
1767    {
1768        size_type __cap = __recommend(__sz);
1769        __p = __alloc_traits::allocate(__alloc(), __cap+1);
1770        __set_long_pointer(__p);
1771        __set_long_cap(__cap+1);
1772        __set_long_size(__sz);
1773    }
1774    traits_type::copy(__p, __s, __sz);
1775    traits_type::assign(__p[__sz], value_type());
1776}
1777
1778template <class _CharT, class _Traits, class _Allocator>
1779_LIBCPP_INLINE_VISIBILITY inline
1780basic_string<_CharT, _Traits, _Allocator>::basic_string(const_pointer __s)
1781{
1782#ifdef _LIBCPP_DEBUG
1783    assert(__s != 0);
1784#endif
1785    __init(__s, traits_type::length(__s));
1786}
1787
1788template <class _CharT, class _Traits, class _Allocator>
1789_LIBCPP_INLINE_VISIBILITY inline
1790basic_string<_CharT, _Traits, _Allocator>::basic_string(const_pointer __s, const allocator_type& __a)
1791    : __r_(__a)
1792{
1793#ifdef _LIBCPP_DEBUG
1794    assert(__s != 0);
1795#endif
1796    __init(__s, traits_type::length(__s));
1797}
1798
1799template <class _CharT, class _Traits, class _Allocator>
1800_LIBCPP_INLINE_VISIBILITY inline
1801basic_string<_CharT, _Traits, _Allocator>::basic_string(const_pointer __s, size_type __n)
1802{
1803#ifdef _LIBCPP_DEBUG
1804    assert(__s != 0);
1805#endif
1806    __init(__s, __n);
1807}
1808
1809template <class _CharT, class _Traits, class _Allocator>
1810_LIBCPP_INLINE_VISIBILITY inline
1811basic_string<_CharT, _Traits, _Allocator>::basic_string(const_pointer __s, size_type __n, const allocator_type& __a)
1812    : __r_(__a)
1813{
1814#ifdef _LIBCPP_DEBUG
1815    assert(__s != 0);
1816#endif
1817    __init(__s, __n);
1818}
1819
1820template <class _CharT, class _Traits, class _Allocator>
1821basic_string<_CharT, _Traits, _Allocator>::basic_string(const basic_string& __str)
1822    : __r_(__alloc_traits::select_on_container_copy_construction(__str.__alloc()))
1823{
1824    if (!__str.__is_long())
1825        __r_.first().__r = __str.__r_.first().__r;
1826    else
1827        __init(__str.__get_long_pointer(), __str.__get_long_size());
1828}
1829
1830template <class _CharT, class _Traits, class _Allocator>
1831basic_string<_CharT, _Traits, _Allocator>::basic_string(const basic_string& __str, const allocator_type& __a)
1832    : __r_(__a)
1833{
1834    if (!__str.__is_long())
1835        __r_.first().__r = __str.__r_.first().__r;
1836    else
1837        __init(__str.__get_long_pointer(), __str.__get_long_size());
1838}
1839
1840#ifndef _LIBCPP_HAS_NO_RVALUE_REFERENCES
1841
1842template <class _CharT, class _Traits, class _Allocator>
1843_LIBCPP_INLINE_VISIBILITY inline
1844basic_string<_CharT, _Traits, _Allocator>::basic_string(basic_string&& __str)
1845        _NOEXCEPT_(is_nothrow_move_constructible<allocator_type>::value)
1846    : __r_(_VSTD::move(__str.__r_))
1847{
1848    __str.__zero();
1849#ifdef _LIBCPP_DEBUG
1850    __str.__invalidate_all_iterators();
1851#endif
1852}
1853
1854template <class _CharT, class _Traits, class _Allocator>
1855_LIBCPP_INLINE_VISIBILITY inline
1856basic_string<_CharT, _Traits, _Allocator>::basic_string(basic_string&& __str, const allocator_type& __a)
1857    : __r_(__a)
1858{
1859    if (__a == __str.__alloc() || !__str.__is_long())
1860        __r_.first().__r = __str.__r_.first().__r;
1861    else
1862        __init(__str.__get_long_pointer(), __str.__get_long_size());
1863    __str.__zero();
1864#ifdef _LIBCPP_DEBUG
1865    __str.__invalidate_all_iterators();
1866#endif
1867}
1868
1869#endif  // _LIBCPP_HAS_NO_RVALUE_REFERENCES
1870
1871template <class _CharT, class _Traits, class _Allocator>
1872void
1873basic_string<_CharT, _Traits, _Allocator>::__init(size_type __n, value_type __c)
1874{
1875    if (__n > max_size())
1876        this->__throw_length_error();
1877    pointer __p;
1878    if (__n < __min_cap)
1879    {
1880        __set_short_size(__n);
1881        __p = __get_short_pointer();
1882    }
1883    else
1884    {
1885        size_type __cap = __recommend(__n);
1886        __p = __alloc_traits::allocate(__alloc(), __cap+1);
1887        __set_long_pointer(__p);
1888        __set_long_cap(__cap+1);
1889        __set_long_size(__n);
1890    }
1891    traits_type::assign(__p, __n, __c);
1892    traits_type::assign(__p[__n], value_type());
1893}
1894
1895template <class _CharT, class _Traits, class _Allocator>
1896_LIBCPP_INLINE_VISIBILITY inline
1897basic_string<_CharT, _Traits, _Allocator>::basic_string(size_type __n, value_type __c)
1898{
1899    __init(__n, __c);
1900}
1901
1902template <class _CharT, class _Traits, class _Allocator>
1903_LIBCPP_INLINE_VISIBILITY inline
1904basic_string<_CharT, _Traits, _Allocator>::basic_string(size_type __n, value_type __c, const allocator_type& __a)
1905    : __r_(__a)
1906{
1907    __init(__n, __c);
1908}
1909
1910template <class _CharT, class _Traits, class _Allocator>
1911basic_string<_CharT, _Traits, _Allocator>::basic_string(const basic_string& __str, size_type __pos, size_type __n,
1912                                                        const allocator_type& __a)
1913    : __r_(__a)
1914{
1915    size_type __str_sz = __str.size();
1916    if (__pos > __str_sz)
1917        this->__throw_out_of_range();
1918    __init(__str.data() + __pos, _VSTD::min(__n, __str_sz - __pos));
1919}
1920
1921template <class _CharT, class _Traits, class _Allocator>
1922template <class _InputIterator>
1923typename enable_if
1924<
1925     __is_input_iterator  <_InputIterator>::value &&
1926    !__is_forward_iterator<_InputIterator>::value,
1927    void
1928>::type
1929basic_string<_CharT, _Traits, _Allocator>::__init(_InputIterator __first, _InputIterator __last)
1930{
1931    __zero();
1932#ifndef _LIBCPP_NO_EXCEPTIONS
1933    try
1934    {
1935#endif  // _LIBCPP_NO_EXCEPTIONS
1936    for (; __first != __last; ++__first)
1937        push_back(*__first);
1938#ifndef _LIBCPP_NO_EXCEPTIONS
1939    }
1940    catch (...)
1941    {
1942        if (__is_long())
1943            __alloc_traits::deallocate(__alloc(), __get_long_pointer(), __get_long_cap());
1944        throw;
1945    }
1946#endif  // _LIBCPP_NO_EXCEPTIONS
1947}
1948
1949template <class _CharT, class _Traits, class _Allocator>
1950template <class _ForwardIterator>
1951typename enable_if
1952<
1953    __is_forward_iterator<_ForwardIterator>::value,
1954    void
1955>::type
1956basic_string<_CharT, _Traits, _Allocator>::__init(_ForwardIterator __first, _ForwardIterator __last)
1957{
1958    size_type __sz = static_cast<size_type>(_VSTD::distance(__first, __last));
1959    if (__sz > max_size())
1960        this->__throw_length_error();
1961    pointer __p;
1962    if (__sz < __min_cap)
1963    {
1964        __set_short_size(__sz);
1965        __p = __get_short_pointer();
1966    }
1967    else
1968    {
1969        size_type __cap = __recommend(__sz);
1970        __p = __alloc_traits::allocate(__alloc(), __cap+1);
1971        __set_long_pointer(__p);
1972        __set_long_cap(__cap+1);
1973        __set_long_size(__sz);
1974    }
1975    for (; __first != __last; ++__first, ++__p)
1976        traits_type::assign(*__p, *__first);
1977    traits_type::assign(*__p, value_type());
1978}
1979
1980template <class _CharT, class _Traits, class _Allocator>
1981template<class _InputIterator>
1982_LIBCPP_INLINE_VISIBILITY inline
1983basic_string<_CharT, _Traits, _Allocator>::basic_string(_InputIterator __first, _InputIterator __last)
1984{
1985    __init(__first, __last);
1986}
1987
1988template <class _CharT, class _Traits, class _Allocator>
1989template<class _InputIterator>
1990_LIBCPP_INLINE_VISIBILITY inline
1991basic_string<_CharT, _Traits, _Allocator>::basic_string(_InputIterator __first, _InputIterator __last,
1992                                                        const allocator_type& __a)
1993    : __r_(__a)
1994{
1995    __init(__first, __last);
1996}
1997
1998#ifndef _LIBCPP_HAS_NO_GENERALIZED_INITIALIZERS
1999
2000template <class _CharT, class _Traits, class _Allocator>
2001_LIBCPP_INLINE_VISIBILITY inline
2002basic_string<_CharT, _Traits, _Allocator>::basic_string(initializer_list<value_type> __il)
2003{
2004    __init(__il.begin(), __il.end());
2005}
2006
2007template <class _CharT, class _Traits, class _Allocator>
2008_LIBCPP_INLINE_VISIBILITY inline
2009basic_string<_CharT, _Traits, _Allocator>::basic_string(initializer_list<value_type> __il, const allocator_type& __a)
2010    : __r_(__a)
2011{
2012    __init(__il.begin(), __il.end());
2013}
2014
2015#endif  // _LIBCPP_HAS_NO_GENERALIZED_INITIALIZERS
2016
2017template <class _CharT, class _Traits, class _Allocator>
2018basic_string<_CharT, _Traits, _Allocator>::~basic_string()
2019{
2020    __invalidate_all_iterators();
2021    if (__is_long())
2022        __alloc_traits::deallocate(__alloc(), __get_long_pointer(), __get_long_cap());
2023}
2024
2025template <class _CharT, class _Traits, class _Allocator>
2026void
2027basic_string<_CharT, _Traits, _Allocator>::__grow_by_and_replace
2028    (size_type __old_cap, size_type __delta_cap, size_type __old_sz,
2029     size_type __n_copy,  size_type __n_del,     size_type __n_add, const_pointer __p_new_stuff)
2030{
2031    size_type __ms = max_size();
2032    if (__delta_cap > __ms - __old_cap - 1)
2033        this->__throw_length_error();
2034    pointer __old_p = __get_pointer();
2035    size_type __cap = __old_cap < __ms / 2 - __alignment ?
2036                          __recommend(_VSTD::max(__old_cap + __delta_cap, 2 * __old_cap)) :
2037                          __ms - 1;
2038    pointer __p = __alloc_traits::allocate(__alloc(), __cap+1);
2039    __invalidate_all_iterators();
2040    if (__n_copy != 0)
2041        traits_type::copy(__p, __old_p, __n_copy);
2042    if (__n_add != 0)
2043        traits_type::copy(__p + __n_copy, __p_new_stuff, __n_add);
2044    size_type __sec_cp_sz = __old_sz - __n_del - __n_copy;
2045    if (__sec_cp_sz != 0)
2046        traits_type::copy(__p + __n_copy + __n_add, __old_p + __n_copy + __n_del, __sec_cp_sz);
2047    if (__old_cap+1 != __min_cap)
2048        __alloc_traits::deallocate(__alloc(), __old_p, __old_cap+1);
2049    __set_long_pointer(__p);
2050    __set_long_cap(__cap+1);
2051    __old_sz = __n_copy + __n_add + __sec_cp_sz;
2052    __set_long_size(__old_sz);
2053    traits_type::assign(__p[__old_sz], value_type());
2054}
2055
2056template <class _CharT, class _Traits, class _Allocator>
2057void
2058basic_string<_CharT, _Traits, _Allocator>::__grow_by(size_type __old_cap, size_type __delta_cap, size_type __old_sz,
2059                                                     size_type __n_copy,  size_type __n_del,     size_type __n_add)
2060{
2061    size_type __ms = max_size();
2062    if (__delta_cap > __ms - __old_cap - 1)
2063        this->__throw_length_error();
2064    pointer __old_p = __get_pointer();
2065    size_type __cap = __old_cap < __ms / 2 - __alignment ?
2066                          __recommend(_VSTD::max(__old_cap + __delta_cap, 2 * __old_cap)) :
2067                          __ms - 1;
2068    pointer __p = __alloc_traits::allocate(__alloc(), __cap+1);
2069    __invalidate_all_iterators();
2070    if (__n_copy != 0)
2071        traits_type::copy(__p, __old_p, __n_copy);
2072    size_type __sec_cp_sz = __old_sz - __n_del - __n_copy;
2073    if (__sec_cp_sz != 0)
2074        traits_type::copy(__p + __n_copy + __n_add, __old_p + __n_copy + __n_del, __sec_cp_sz);
2075    if (__old_cap+1 != __min_cap)
2076        __alloc_traits::deallocate(__alloc(), __old_p, __old_cap+1);
2077    __set_long_pointer(__p);
2078    __set_long_cap(__cap+1);
2079}
2080
2081// assign
2082
2083template <class _CharT, class _Traits, class _Allocator>
2084basic_string<_CharT, _Traits, _Allocator>&
2085basic_string<_CharT, _Traits, _Allocator>::assign(const_pointer __s, size_type __n)
2086{
2087#ifdef _LIBCPP_DEBUG
2088    assert(__s != 0);
2089#endif
2090    size_type __cap = capacity();
2091    if (__cap >= __n)
2092    {
2093        pointer __p = __get_pointer();
2094        traits_type::move(__p, __s, __n);
2095        traits_type::assign(__p[__n], value_type());
2096        __set_size(__n);
2097        __invalidate_iterators_past(__n);
2098    }
2099    else
2100    {
2101        size_type __sz = size();
2102        __grow_by_and_replace(__cap, __n - __cap, __sz, 0, __sz, __n, __s);
2103    }
2104    return *this;
2105}
2106
2107template <class _CharT, class _Traits, class _Allocator>
2108basic_string<_CharT, _Traits, _Allocator>&
2109basic_string<_CharT, _Traits, _Allocator>::assign(size_type __n, value_type __c)
2110{
2111    size_type __cap = capacity();
2112    if (__cap < __n)
2113    {
2114        size_type __sz = size();
2115        __grow_by(__cap, __n - __cap, __sz, 0, __sz);
2116    }
2117    else
2118        __invalidate_iterators_past(__n);
2119    pointer __p = __get_pointer();
2120    traits_type::assign(__p, __n, __c);
2121    traits_type::assign(__p[__n], value_type());
2122    __set_size(__n);
2123    return *this;
2124}
2125
2126template <class _CharT, class _Traits, class _Allocator>
2127basic_string<_CharT, _Traits, _Allocator>&
2128basic_string<_CharT, _Traits, _Allocator>::operator=(value_type __c)
2129{
2130    pointer __p;
2131    if (__is_long())
2132    {
2133        __p = __get_long_pointer();
2134        __set_long_size(1);
2135    }
2136    else
2137    {
2138        __p = __get_short_pointer();
2139        __set_short_size(1);
2140    }
2141    traits_type::assign(*__p, __c);
2142    traits_type::assign(*++__p, value_type());
2143    __invalidate_iterators_past(1);
2144    return *this;
2145}
2146
2147template <class _CharT, class _Traits, class _Allocator>
2148basic_string<_CharT, _Traits, _Allocator>&
2149basic_string<_CharT, _Traits, _Allocator>::operator=(const basic_string& __str)
2150{
2151    if (this != &__str)
2152    {
2153        __copy_assign_alloc(__str);
2154        assign(__str);
2155    }
2156    return *this;
2157}
2158
2159#ifndef _LIBCPP_HAS_NO_RVALUE_REFERENCES
2160
2161template <class _CharT, class _Traits, class _Allocator>
2162_LIBCPP_INLINE_VISIBILITY inline
2163void
2164basic_string<_CharT, _Traits, _Allocator>::__move_assign(basic_string& __str, false_type)
2165{
2166    if (__alloc() != __str.__alloc())
2167        assign(__str);
2168    else
2169        __move_assign(__str, true_type());
2170}
2171
2172template <class _CharT, class _Traits, class _Allocator>
2173_LIBCPP_INLINE_VISIBILITY inline
2174void
2175basic_string<_CharT, _Traits, _Allocator>::__move_assign(basic_string& __str, true_type)
2176    _NOEXCEPT_(is_nothrow_move_assignable<allocator_type>::value)
2177{
2178    clear();
2179    shrink_to_fit();
2180    __r_.first() = __str.__r_.first();
2181    __move_assign_alloc(__str);
2182    __str.__zero();
2183}
2184
2185template <class _CharT, class _Traits, class _Allocator>
2186_LIBCPP_INLINE_VISIBILITY inline
2187basic_string<_CharT, _Traits, _Allocator>&
2188basic_string<_CharT, _Traits, _Allocator>::operator=(basic_string&& __str)
2189    _NOEXCEPT_(__alloc_traits::propagate_on_container_move_assignment::value &&
2190               is_nothrow_move_assignable<allocator_type>::value)
2191{
2192    __move_assign(__str, integral_constant<bool,
2193          __alloc_traits::propagate_on_container_move_assignment::value>());
2194    return *this;
2195}
2196
2197#endif
2198
2199template <class _CharT, class _Traits, class _Allocator>
2200template<class _InputIterator>
2201typename enable_if
2202<
2203     __is_input_iterator  <_InputIterator>::value &&
2204    !__is_forward_iterator<_InputIterator>::value,
2205    basic_string<_CharT, _Traits, _Allocator>&
2206>::type
2207basic_string<_CharT, _Traits, _Allocator>::assign(_InputIterator __first, _InputIterator __last)
2208{
2209    clear();
2210    for (; __first != __last; ++__first)
2211        push_back(*__first);
2212    return *this;
2213}
2214
2215template <class _CharT, class _Traits, class _Allocator>
2216template<class _ForwardIterator>
2217typename enable_if
2218<
2219    __is_forward_iterator<_ForwardIterator>::value,
2220    basic_string<_CharT, _Traits, _Allocator>&
2221>::type
2222basic_string<_CharT, _Traits, _Allocator>::assign(_ForwardIterator __first, _ForwardIterator __last)
2223{
2224    size_type __n = static_cast<size_type>(_VSTD::distance(__first, __last));
2225    size_type __cap = capacity();
2226    if (__cap < __n)
2227    {
2228        size_type __sz = size();
2229        __grow_by(__cap, __n - __cap, __sz, 0, __sz);
2230    }
2231    else
2232        __invalidate_iterators_past(__n);
2233    pointer __p = __get_pointer();
2234    for (; __first != __last; ++__first, ++__p)
2235        traits_type::assign(*__p, *__first);
2236    traits_type::assign(*__p, value_type());
2237    __set_size(__n);
2238    return *this;
2239}
2240
2241template <class _CharT, class _Traits, class _Allocator>
2242_LIBCPP_INLINE_VISIBILITY inline
2243basic_string<_CharT, _Traits, _Allocator>&
2244basic_string<_CharT, _Traits, _Allocator>::assign(const basic_string& __str)
2245{
2246    return assign(__str.data(), __str.size());
2247}
2248
2249template <class _CharT, class _Traits, class _Allocator>
2250basic_string<_CharT, _Traits, _Allocator>&
2251basic_string<_CharT, _Traits, _Allocator>::assign(const basic_string& __str, size_type __pos, size_type __n)
2252{
2253    size_type __sz = __str.size();
2254    if (__pos > __sz)
2255        this->__throw_out_of_range();
2256    return assign(__str.data() + __pos, _VSTD::min(__n, __sz - __pos));
2257}
2258
2259template <class _CharT, class _Traits, class _Allocator>
2260basic_string<_CharT, _Traits, _Allocator>&
2261basic_string<_CharT, _Traits, _Allocator>::assign(const_pointer __s)
2262{
2263#ifdef _LIBCPP_DEBUG
2264    assert(__s != 0);
2265#endif
2266    return assign(__s, traits_type::length(__s));
2267}
2268
2269// append
2270
2271template <class _CharT, class _Traits, class _Allocator>
2272basic_string<_CharT, _Traits, _Allocator>&
2273basic_string<_CharT, _Traits, _Allocator>::append(const_pointer __s, size_type __n)
2274{
2275#ifdef _LIBCPP_DEBUG
2276    assert(__s != 0);
2277#endif
2278    size_type __cap = capacity();
2279    size_type __sz = size();
2280    if (__cap - __sz >= __n)
2281    {
2282        if (__n)
2283        {
2284            pointer __p = __get_pointer();
2285            traits_type::copy(__p + __sz, __s, __n);
2286            __sz += __n;
2287            __set_size(__sz);
2288            traits_type::assign(__p[__sz], value_type());
2289        }
2290    }
2291    else
2292        __grow_by_and_replace(__cap, __sz + __n - __cap, __sz, __sz, 0, __n, __s);
2293    return *this;
2294}
2295
2296template <class _CharT, class _Traits, class _Allocator>
2297basic_string<_CharT, _Traits, _Allocator>&
2298basic_string<_CharT, _Traits, _Allocator>::append(size_type __n, value_type __c)
2299{
2300    if (__n)
2301    {
2302        size_type __cap = capacity();
2303        size_type __sz = size();
2304        if (__cap - __sz < __n)
2305            __grow_by(__cap, __sz + __n - __cap, __sz, __sz, 0);
2306        pointer __p = __get_pointer();
2307        traits_type::assign(__p + __sz, __n, __c);
2308        __sz += __n;
2309        __set_size(__sz);
2310        traits_type::assign(__p[__sz], value_type());
2311    }
2312    return *this;
2313}
2314
2315template <class _CharT, class _Traits, class _Allocator>
2316void
2317basic_string<_CharT, _Traits, _Allocator>::push_back(value_type __c)
2318{
2319    size_type __cap = capacity();
2320    size_type __sz = size();
2321    if (__sz == __cap)
2322        __grow_by(__cap, 1, __sz, __sz, 0);
2323    pointer __p = __get_pointer() + __sz;
2324    traits_type::assign(*__p, __c);
2325    traits_type::assign(*++__p, value_type());
2326    __set_size(__sz+1);
2327}
2328
2329template <class _CharT, class _Traits, class _Allocator>
2330template<class _InputIterator>
2331typename enable_if
2332<
2333     __is_input_iterator  <_InputIterator>::value &&
2334    !__is_forward_iterator<_InputIterator>::value,
2335    basic_string<_CharT, _Traits, _Allocator>&
2336>::type
2337basic_string<_CharT, _Traits, _Allocator>::append(_InputIterator __first, _InputIterator __last)
2338{
2339    for (; __first != __last; ++__first)
2340        push_back(*__first);
2341    return *this;
2342}
2343
2344template <class _CharT, class _Traits, class _Allocator>
2345template<class _ForwardIterator>
2346typename enable_if
2347<
2348    __is_forward_iterator<_ForwardIterator>::value,
2349    basic_string<_CharT, _Traits, _Allocator>&
2350>::type
2351basic_string<_CharT, _Traits, _Allocator>::append(_ForwardIterator __first, _ForwardIterator __last)
2352{
2353    size_type __sz = size();
2354    size_type __cap = capacity();
2355    size_type __n = static_cast<size_type>(_VSTD::distance(__first, __last));
2356    if (__n)
2357    {
2358        if (__cap - __sz < __n)
2359            __grow_by(__cap, __sz + __n - __cap, __sz, __sz, 0);
2360        pointer __p = __get_pointer() + __sz;
2361        for (; __first != __last; ++__p, ++__first)
2362            traits_type::assign(*__p, *__first);
2363        traits_type::assign(*__p, value_type());
2364        __set_size(__sz + __n);
2365    }
2366    return *this;
2367}
2368
2369template <class _CharT, class _Traits, class _Allocator>
2370_LIBCPP_INLINE_VISIBILITY inline
2371basic_string<_CharT, _Traits, _Allocator>&
2372basic_string<_CharT, _Traits, _Allocator>::append(const basic_string& __str)
2373{
2374    return append(__str.data(), __str.size());
2375}
2376
2377template <class _CharT, class _Traits, class _Allocator>
2378basic_string<_CharT, _Traits, _Allocator>&
2379basic_string<_CharT, _Traits, _Allocator>::append(const basic_string& __str, size_type __pos, size_type __n)
2380{
2381    size_type __sz = __str.size();
2382    if (__pos > __sz)
2383        this->__throw_out_of_range();
2384    return append(__str.data() + __pos, _VSTD::min(__n, __sz - __pos));
2385}
2386
2387template <class _CharT, class _Traits, class _Allocator>
2388basic_string<_CharT, _Traits, _Allocator>&
2389basic_string<_CharT, _Traits, _Allocator>::append(const_pointer __s)
2390{
2391#ifdef _LIBCPP_DEBUG
2392    assert(__s != 0);
2393#endif
2394    return append(__s, traits_type::length(__s));
2395}
2396
2397// insert
2398
2399template <class _CharT, class _Traits, class _Allocator>
2400basic_string<_CharT, _Traits, _Allocator>&
2401basic_string<_CharT, _Traits, _Allocator>::insert(size_type __pos, const_pointer __s, size_type __n)
2402{
2403#ifdef _LIBCPP_DEBUG
2404    assert(__s != 0);
2405#endif
2406    size_type __sz = size();
2407    if (__pos > __sz)
2408        this->__throw_out_of_range();
2409    size_type __cap = capacity();
2410    if (__cap - __sz >= __n)
2411    {
2412        if (__n)
2413        {
2414            pointer __p = __get_pointer();
2415            size_type __n_move = __sz - __pos;
2416            if (__n_move != 0)
2417            {
2418                if (__p + __pos <= __s && __s < __p + __sz)
2419                    __s += __n;
2420                traits_type::move(__p + __pos + __n, __p + __pos, __n_move);
2421            }
2422            traits_type::move(__p + __pos, __s, __n);
2423            __sz += __n;
2424            __set_size(__sz);
2425            traits_type::assign(__p[__sz], value_type());
2426        }
2427    }
2428    else
2429        __grow_by_and_replace(__cap, __sz + __n - __cap, __sz, __pos, 0, __n, __s);
2430    return *this;
2431}
2432
2433template <class _CharT, class _Traits, class _Allocator>
2434basic_string<_CharT, _Traits, _Allocator>&
2435basic_string<_CharT, _Traits, _Allocator>::insert(size_type __pos, size_type __n, value_type __c)
2436{
2437    size_type __sz = size();
2438    if (__pos > __sz)
2439        this->__throw_out_of_range();
2440    if (__n)
2441    {
2442        size_type __cap = capacity();
2443        pointer __p;
2444        if (__cap - __sz >= __n)
2445        {
2446            __p = __get_pointer();
2447            size_type __n_move = __sz - __pos;
2448            if (__n_move != 0)
2449                traits_type::move(__p + __pos + __n, __p + __pos, __n_move);
2450        }
2451        else
2452        {
2453            __grow_by(__cap, __sz + __n - __cap, __sz, __pos, 0, __n);
2454            __p = __get_long_pointer();
2455        }
2456        traits_type::assign(__p + __pos, __n, __c);
2457        __sz += __n;
2458        __set_size(__sz);
2459        traits_type::assign(__p[__sz], value_type());
2460    }
2461    return *this;
2462}
2463
2464template <class _CharT, class _Traits, class _Allocator>
2465template<class _InputIterator>
2466typename enable_if
2467<
2468     __is_input_iterator  <_InputIterator>::value &&
2469    !__is_forward_iterator<_InputIterator>::value,
2470    typename basic_string<_CharT, _Traits, _Allocator>::iterator
2471>::type
2472basic_string<_CharT, _Traits, _Allocator>::insert(const_iterator __pos, _InputIterator __first, _InputIterator __last)
2473{
2474    size_type __old_sz = size();
2475    difference_type __ip = __pos - begin();
2476    for (; __first != __last; ++__first)
2477        push_back(*__first);
2478    pointer __p = __get_pointer();
2479    _VSTD::rotate(__p + __ip, __p + __old_sz, __p + size());
2480    return iterator(__p + __ip);
2481}
2482
2483template <class _CharT, class _Traits, class _Allocator>
2484template<class _ForwardIterator>
2485typename enable_if
2486<
2487    __is_forward_iterator<_ForwardIterator>::value,
2488    typename basic_string<_CharT, _Traits, _Allocator>::iterator
2489>::type
2490basic_string<_CharT, _Traits, _Allocator>::insert(const_iterator __pos, _ForwardIterator __first, _ForwardIterator __last)
2491{
2492    size_type __ip = static_cast<size_type>(__pos - begin());
2493    size_type __sz = size();
2494    size_type __cap = capacity();
2495    size_type __n = static_cast<size_type>(_VSTD::distance(__first, __last));
2496    if (__n)
2497    {
2498        pointer __p;
2499        if (__cap - __sz >= __n)
2500        {
2501            __p = __get_pointer();
2502            size_type __n_move = __sz - __ip;
2503            if (__n_move != 0)
2504                traits_type::move(__p + __ip + __n, __p + __ip, __n_move);
2505        }
2506        else
2507        {
2508            __grow_by(__cap, __sz + __n - __cap, __sz, __ip, 0, __n);
2509            __p = __get_long_pointer();
2510        }
2511        __sz += __n;
2512        __set_size(__sz);
2513        traits_type::assign(__p[__sz], value_type());
2514        for (__p += __ip; __first != __last; ++__p, ++__first)
2515            traits_type::assign(*__p, *__first);
2516    }
2517    return begin() + __ip;
2518}
2519
2520template <class _CharT, class _Traits, class _Allocator>
2521_LIBCPP_INLINE_VISIBILITY inline
2522basic_string<_CharT, _Traits, _Allocator>&
2523basic_string<_CharT, _Traits, _Allocator>::insert(size_type __pos1, const basic_string& __str)
2524{
2525    return insert(__pos1, __str.data(), __str.size());
2526}
2527
2528template <class _CharT, class _Traits, class _Allocator>
2529basic_string<_CharT, _Traits, _Allocator>&
2530basic_string<_CharT, _Traits, _Allocator>::insert(size_type __pos1, const basic_string& __str,
2531                                                  size_type __pos2, size_type __n)
2532{
2533    size_type __str_sz = __str.size();
2534    if (__pos2 > __str_sz)
2535        this->__throw_out_of_range();
2536    return insert(__pos1, __str.data() + __pos2, _VSTD::min(__n, __str_sz - __pos2));
2537}
2538
2539template <class _CharT, class _Traits, class _Allocator>
2540basic_string<_CharT, _Traits, _Allocator>&
2541basic_string<_CharT, _Traits, _Allocator>::insert(size_type __pos, const_pointer __s)
2542{
2543#ifdef _LIBCPP_DEBUG
2544    assert(__s != 0);
2545#endif
2546    return insert(__pos, __s, traits_type::length(__s));
2547}
2548
2549template <class _CharT, class _Traits, class _Allocator>
2550typename basic_string<_CharT, _Traits, _Allocator>::iterator
2551basic_string<_CharT, _Traits, _Allocator>::insert(const_iterator __pos, value_type __c)
2552{
2553    size_type __ip = static_cast<size_type>(__pos - begin());
2554    size_type __sz = size();
2555    size_type __cap = capacity();
2556    pointer __p;
2557    if (__cap == __sz)
2558    {
2559        __grow_by(__cap, 1, __sz, __ip, 0, 1);
2560        __p = __get_long_pointer();
2561    }
2562    else
2563    {
2564        __p = __get_pointer();
2565        size_type __n_move = __sz - __ip;
2566        if (__n_move != 0)
2567            traits_type::move(__p + __ip + 1, __p + __ip, __n_move);
2568    }
2569    traits_type::assign(__p[__ip], __c);
2570    traits_type::assign(__p[++__sz], value_type());
2571    __set_size(__sz);
2572    return begin() + static_cast<difference_type>(__ip);
2573}
2574
2575template <class _CharT, class _Traits, class _Allocator>
2576_LIBCPP_INLINE_VISIBILITY inline
2577typename basic_string<_CharT, _Traits, _Allocator>::iterator
2578basic_string<_CharT, _Traits, _Allocator>::insert(const_iterator __pos, size_type __n, value_type __c)
2579{
2580    difference_type __p = __pos - begin();
2581    insert(static_cast<size_type>(__p), __n, __c);
2582    return begin() + __p;
2583}
2584
2585// replace
2586
2587template <class _CharT, class _Traits, class _Allocator>
2588basic_string<_CharT, _Traits, _Allocator>&
2589basic_string<_CharT, _Traits, _Allocator>::replace(size_type __pos, size_type __n1, const_pointer __s, size_type __n2)
2590{
2591#ifdef _LIBCPP_DEBUG
2592    assert(__s != 0);
2593#endif
2594    size_type __sz = size();
2595    if (__pos > __sz)
2596        this->__throw_out_of_range();
2597    __n1 = _VSTD::min(__n1, __sz - __pos);
2598    size_type __cap = capacity();
2599    if (__cap - __sz + __n1 >= __n2)
2600    {
2601        pointer __p = __get_pointer();
2602        if (__n1 != __n2)
2603        {
2604            size_type __n_move = __sz - __pos - __n1;
2605            if (__n_move != 0)
2606            {
2607                if (__n1 > __n2)
2608                {
2609                    traits_type::move(__p + __pos, __s, __n2);
2610                    traits_type::move(__p + __pos + __n2, __p + __pos + __n1, __n_move);
2611                    goto __finish;
2612                }
2613                if (__p + __pos < __s && __s < __p + __sz)
2614                {
2615                    if (__p + __pos + __n1 <= __s)
2616                        __s += __n2 - __n1;
2617                    else // __p + __pos < __s < __p + __pos + __n1
2618                    {
2619                        traits_type::move(__p + __pos, __s, __n1);
2620                        __pos += __n1;
2621                        __s += __n2;
2622                        __n2 -= __n1;
2623                        __n1 = 0;
2624                    }
2625                }
2626                traits_type::move(__p + __pos + __n2, __p + __pos + __n1, __n_move);
2627            }
2628        }
2629        traits_type::move(__p + __pos, __s, __n2);
2630__finish:
2631        __sz += __n2 - __n1;
2632        __set_size(__sz);
2633        __invalidate_iterators_past(__sz);
2634        traits_type::assign(__p[__sz], value_type());
2635    }
2636    else
2637        __grow_by_and_replace(__cap, __sz - __n1 + __n2 - __cap, __sz, __pos, __n1, __n2, __s);
2638    return *this;
2639}
2640
2641template <class _CharT, class _Traits, class _Allocator>
2642basic_string<_CharT, _Traits, _Allocator>&
2643basic_string<_CharT, _Traits, _Allocator>::replace(size_type __pos, size_type __n1, size_type __n2, value_type __c)
2644{
2645    size_type __sz = size();
2646    if (__pos > __sz)
2647        this->__throw_out_of_range();
2648    __n1 = _VSTD::min(__n1, __sz - __pos);
2649    size_type __cap = capacity();
2650    pointer __p;
2651    if (__cap - __sz + __n1 >= __n2)
2652    {
2653        __p = __get_pointer();
2654        if (__n1 != __n2)
2655        {
2656            size_type __n_move = __sz - __pos - __n1;
2657            if (__n_move != 0)
2658                traits_type::move(__p + __pos + __n2, __p + __pos + __n1, __n_move);
2659        }
2660    }
2661    else
2662    {
2663        __grow_by(__cap, __sz - __n1 + __n2 - __cap, __sz, __pos, __n1, __n2);
2664        __p = __get_long_pointer();
2665    }
2666    traits_type::assign(__p + __pos, __n2, __c);
2667    __sz += __n2 - __n1;
2668    __set_size(__sz);
2669    __invalidate_iterators_past(__sz);
2670    traits_type::assign(__p[__sz], value_type());
2671    return *this;
2672}
2673
2674template <class _CharT, class _Traits, class _Allocator>
2675template<class _InputIterator>
2676typename enable_if
2677<
2678    __is_input_iterator<_InputIterator>::value,
2679    basic_string<_CharT, _Traits, _Allocator>&
2680>::type
2681basic_string<_CharT, _Traits, _Allocator>::replace(const_iterator __i1, const_iterator __i2,
2682                                                   _InputIterator __j1, _InputIterator __j2)
2683{
2684    for (; true; ++__i1, ++__j1)
2685    {
2686        if (__i1 == __i2)
2687        {
2688            if (__j1 != __j2)
2689                insert(__i1, __j1, __j2);
2690            break;
2691        }
2692        if (__j1 == __j2)
2693        {
2694            erase(__i1, __i2);
2695            break;
2696        }
2697        traits_type::assign(const_cast<value_type&>(*__i1), *__j1);
2698    }
2699    return *this;
2700}
2701
2702template <class _CharT, class _Traits, class _Allocator>
2703_LIBCPP_INLINE_VISIBILITY inline
2704basic_string<_CharT, _Traits, _Allocator>&
2705basic_string<_CharT, _Traits, _Allocator>::replace(size_type __pos1, size_type __n1, const basic_string& __str)
2706{
2707    return replace(__pos1, __n1, __str.data(), __str.size());
2708}
2709
2710template <class _CharT, class _Traits, class _Allocator>
2711basic_string<_CharT, _Traits, _Allocator>&
2712basic_string<_CharT, _Traits, _Allocator>::replace(size_type __pos1, size_type __n1, const basic_string& __str,
2713                                                   size_type __pos2, size_type __n2)
2714{
2715    size_type __str_sz = __str.size();
2716    if (__pos2 > __str_sz)
2717        this->__throw_out_of_range();
2718    return replace(__pos1, __n1, __str.data() + __pos2, _VSTD::min(__n2, __str_sz - __pos2));
2719}
2720
2721template <class _CharT, class _Traits, class _Allocator>
2722basic_string<_CharT, _Traits, _Allocator>&
2723basic_string<_CharT, _Traits, _Allocator>::replace(size_type __pos, size_type __n1, const_pointer __s)
2724{
2725#ifdef _LIBCPP_DEBUG
2726    assert(__s != 0);
2727#endif
2728    return replace(__pos, __n1, __s, traits_type::length(__s));
2729}
2730
2731template <class _CharT, class _Traits, class _Allocator>
2732_LIBCPP_INLINE_VISIBILITY inline
2733basic_string<_CharT, _Traits, _Allocator>&
2734basic_string<_CharT, _Traits, _Allocator>::replace(const_iterator __i1, const_iterator __i2, const basic_string& __str)
2735{
2736    return replace(static_cast<size_type>(__i1 - begin()), static_cast<size_type>(__i2 - __i1),
2737                   __str.data(), __str.size());
2738}
2739
2740template <class _CharT, class _Traits, class _Allocator>
2741_LIBCPP_INLINE_VISIBILITY inline
2742basic_string<_CharT, _Traits, _Allocator>&
2743basic_string<_CharT, _Traits, _Allocator>::replace(const_iterator __i1, const_iterator __i2, const_pointer __s, size_type __n)
2744{
2745    return replace(static_cast<size_type>(__i1 - begin()), static_cast<size_type>(__i2 - __i1), __s, __n);
2746}
2747
2748template <class _CharT, class _Traits, class _Allocator>
2749_LIBCPP_INLINE_VISIBILITY inline
2750basic_string<_CharT, _Traits, _Allocator>&
2751basic_string<_CharT, _Traits, _Allocator>::replace(const_iterator __i1, const_iterator __i2, const_pointer __s)
2752{
2753    return replace(static_cast<size_type>(__i1 - begin()), static_cast<size_type>(__i2 - __i1), __s);
2754}
2755
2756template <class _CharT, class _Traits, class _Allocator>
2757_LIBCPP_INLINE_VISIBILITY inline
2758basic_string<_CharT, _Traits, _Allocator>&
2759basic_string<_CharT, _Traits, _Allocator>::replace(const_iterator __i1, const_iterator __i2, size_type __n, value_type __c)
2760{
2761    return replace(static_cast<size_type>(__i1 - begin()), static_cast<size_type>(__i2 - __i1), __n, __c);
2762}
2763
2764// erase
2765
2766template <class _CharT, class _Traits, class _Allocator>
2767basic_string<_CharT, _Traits, _Allocator>&
2768basic_string<_CharT, _Traits, _Allocator>::erase(size_type __pos, size_type __n)
2769{
2770    size_type __sz = size();
2771    if (__pos > __sz)
2772        this->__throw_out_of_range();
2773    if (__n)
2774    {
2775        pointer __p = __get_pointer();
2776        __n = _VSTD::min(__n, __sz - __pos);
2777        size_type __n_move = __sz - __pos - __n;
2778        if (__n_move != 0)
2779            traits_type::move(__p + __pos, __p + __pos + __n, __n_move);
2780        __sz -= __n;
2781        __set_size(__sz);
2782        __invalidate_iterators_past(__sz);
2783        traits_type::assign(__p[__sz], value_type());
2784    }
2785    return *this;
2786}
2787
2788template <class _CharT, class _Traits, class _Allocator>
2789_LIBCPP_INLINE_VISIBILITY inline
2790typename basic_string<_CharT, _Traits, _Allocator>::iterator
2791basic_string<_CharT, _Traits, _Allocator>::erase(const_iterator __pos)
2792{
2793    iterator __b = begin();
2794    size_type __r = static_cast<size_type>(__pos - __b);
2795    erase(__r, 1);
2796    return __b + static_cast<difference_type>(__r);
2797}
2798
2799template <class _CharT, class _Traits, class _Allocator>
2800_LIBCPP_INLINE_VISIBILITY inline
2801typename basic_string<_CharT, _Traits, _Allocator>::iterator
2802basic_string<_CharT, _Traits, _Allocator>::erase(const_iterator __first, const_iterator __last)
2803{
2804    iterator __b = begin();
2805    size_type __r = static_cast<size_type>(__first - __b);
2806    erase(__r, static_cast<size_type>(__last - __first));
2807    return __b + static_cast<difference_type>(__r);
2808}
2809
2810template <class _CharT, class _Traits, class _Allocator>
2811_LIBCPP_INLINE_VISIBILITY inline
2812void
2813basic_string<_CharT, _Traits, _Allocator>::pop_back()
2814{
2815#ifdef _LIBCPP_DEBUG
2816    assert(!empty());
2817#endif
2818    size_type __sz;
2819    if (__is_long())
2820    {
2821        __sz = __get_long_size() - 1;
2822        __set_long_size(__sz);
2823        traits_type::assign(*(__get_long_pointer() + __sz), value_type());
2824    }
2825    else
2826    {
2827        __sz = __get_short_size() - 1;
2828        __set_short_size(__sz);
2829        traits_type::assign(*(__get_short_pointer() + __sz), value_type());
2830    }
2831    __invalidate_iterators_past(__sz);
2832}
2833
2834template <class _CharT, class _Traits, class _Allocator>
2835_LIBCPP_INLINE_VISIBILITY inline
2836void
2837basic_string<_CharT, _Traits, _Allocator>::clear() _NOEXCEPT
2838{
2839    __invalidate_all_iterators();
2840    if (__is_long())
2841    {
2842        traits_type::assign(*__get_long_pointer(), value_type());
2843        __set_long_size(0);
2844    }
2845    else
2846    {
2847        traits_type::assign(*__get_short_pointer(), value_type());
2848        __set_short_size(0);
2849    }
2850}
2851
2852template <class _CharT, class _Traits, class _Allocator>
2853_LIBCPP_INLINE_VISIBILITY inline
2854void
2855basic_string<_CharT, _Traits, _Allocator>::__erase_to_end(size_type __pos)
2856{
2857    if (__is_long())
2858    {
2859        traits_type::assign(*(__get_long_pointer() + __pos), value_type());
2860        __set_long_size(__pos);
2861    }
2862    else
2863    {
2864        traits_type::assign(*(__get_short_pointer() + __pos), value_type());
2865        __set_short_size(__pos);
2866    }
2867    __invalidate_iterators_past(__pos);
2868}
2869
2870template <class _CharT, class _Traits, class _Allocator>
2871void
2872basic_string<_CharT, _Traits, _Allocator>::resize(size_type __n, value_type __c)
2873{
2874    size_type __sz = size();
2875    if (__n > __sz)
2876        append(__n - __sz, __c);
2877    else
2878        __erase_to_end(__n);
2879}
2880
2881template <class _CharT, class _Traits, class _Allocator>
2882_LIBCPP_INLINE_VISIBILITY inline
2883typename basic_string<_CharT, _Traits, _Allocator>::size_type
2884basic_string<_CharT, _Traits, _Allocator>::max_size() const _NOEXCEPT
2885{
2886    size_type __m = __alloc_traits::max_size(__alloc());
2887#if _LIBCPP_BIG_ENDIAN
2888    return (__m <= ~__long_mask ? __m : __m/2) - 1;
2889#else
2890    return __m - 1;
2891#endif
2892}
2893
2894template <class _CharT, class _Traits, class _Allocator>
2895void
2896basic_string<_CharT, _Traits, _Allocator>::reserve(size_type __res_arg)
2897{
2898    if (__res_arg > max_size())
2899        this->__throw_length_error();
2900    size_type __cap = capacity();
2901    size_type __sz = size();
2902    __res_arg = _VSTD::max(__res_arg, __sz);
2903    __res_arg = __recommend(__res_arg);
2904    if (__res_arg != __cap)
2905    {
2906        pointer __new_data, __p;
2907        bool __was_long, __now_long;
2908        if (__res_arg == __min_cap - 1)
2909        {
2910            __was_long = true;
2911            __now_long = false;
2912            __new_data = __get_short_pointer();
2913            __p = __get_long_pointer();
2914        }
2915        else
2916        {
2917            if (__res_arg > __cap)
2918                __new_data = __alloc_traits::allocate(__alloc(), __res_arg+1);
2919            else
2920            {
2921            #ifndef _LIBCPP_NO_EXCEPTIONS
2922                try
2923                {
2924            #endif  // _LIBCPP_NO_EXCEPTIONS
2925                    __new_data = __alloc_traits::allocate(__alloc(), __res_arg+1);
2926            #ifndef _LIBCPP_NO_EXCEPTIONS
2927                }
2928                catch (...)
2929                {
2930                    return;
2931                }
2932            #else  // _LIBCPP_NO_EXCEPTIONS
2933                if (__new_data == 0)
2934                    return;
2935            #endif  // _LIBCPP_NO_EXCEPTIONS
2936            }
2937            __now_long = true;
2938            __was_long = __is_long();
2939            __p = __get_pointer();
2940        }
2941        traits_type::copy(__new_data, __p, size()+1);
2942        if (__was_long)
2943            __alloc_traits::deallocate(__alloc(), __p, __cap+1);
2944        if (__now_long)
2945        {
2946            __set_long_cap(__res_arg+1);
2947            __set_long_size(__sz);
2948            __set_long_pointer(__new_data);
2949        }
2950        else
2951            __set_short_size(__sz);
2952        __invalidate_all_iterators();
2953    }
2954}
2955
2956template <class _CharT, class _Traits, class _Allocator>
2957_LIBCPP_INLINE_VISIBILITY inline
2958typename basic_string<_CharT, _Traits, _Allocator>::const_reference
2959basic_string<_CharT, _Traits, _Allocator>::operator[](size_type __pos) const
2960{
2961#ifdef __LIBCPP_DEBUG
2962    assert(__pos <= size());
2963#endif
2964    return *(data() + __pos);
2965}
2966
2967template <class _CharT, class _Traits, class _Allocator>
2968_LIBCPP_INLINE_VISIBILITY inline
2969typename basic_string<_CharT, _Traits, _Allocator>::reference
2970basic_string<_CharT, _Traits, _Allocator>::operator[](size_type __pos)
2971{
2972#ifdef __LIBCPP_DEBUG
2973    assert(__pos < size());
2974#endif
2975    return *(__get_pointer() + __pos);
2976}
2977
2978template <class _CharT, class _Traits, class _Allocator>
2979typename basic_string<_CharT, _Traits, _Allocator>::const_reference
2980basic_string<_CharT, _Traits, _Allocator>::at(size_type __n) const
2981{
2982    if (__n >= size())
2983        this->__throw_out_of_range();
2984    return (*this)[__n];
2985}
2986
2987template <class _CharT, class _Traits, class _Allocator>
2988typename basic_string<_CharT, _Traits, _Allocator>::reference
2989basic_string<_CharT, _Traits, _Allocator>::at(size_type __n)
2990{
2991    if (__n >= size())
2992        this->__throw_out_of_range();
2993    return (*this)[__n];
2994}
2995
2996template <class _CharT, class _Traits, class _Allocator>
2997_LIBCPP_INLINE_VISIBILITY inline
2998typename basic_string<_CharT, _Traits, _Allocator>::reference
2999basic_string<_CharT, _Traits, _Allocator>::front()
3000{
3001#ifdef _LIBCPP_DEBUG
3002    assert(!empty());
3003#endif
3004    return *__get_pointer();
3005}
3006
3007template <class _CharT, class _Traits, class _Allocator>
3008_LIBCPP_INLINE_VISIBILITY inline
3009typename basic_string<_CharT, _Traits, _Allocator>::const_reference
3010basic_string<_CharT, _Traits, _Allocator>::front() const
3011{
3012#ifdef _LIBCPP_DEBUG
3013    assert(!empty());
3014#endif
3015    return *data();
3016}
3017
3018template <class _CharT, class _Traits, class _Allocator>
3019_LIBCPP_INLINE_VISIBILITY inline
3020typename basic_string<_CharT, _Traits, _Allocator>::reference
3021basic_string<_CharT, _Traits, _Allocator>::back()
3022{
3023#ifdef _LIBCPP_DEBUG
3024    assert(!empty());
3025#endif
3026    return *(__get_pointer() + size() - 1);
3027}
3028
3029template <class _CharT, class _Traits, class _Allocator>
3030_LIBCPP_INLINE_VISIBILITY inline
3031typename basic_string<_CharT, _Traits, _Allocator>::const_reference
3032basic_string<_CharT, _Traits, _Allocator>::back() const
3033{
3034#ifdef _LIBCPP_DEBUG
3035    assert(!empty());
3036#endif
3037    return *(data() + size() - 1);
3038}
3039
3040template <class _CharT, class _Traits, class _Allocator>
3041typename basic_string<_CharT, _Traits, _Allocator>::size_type
3042basic_string<_CharT, _Traits, _Allocator>::copy(pointer __s, size_type __n, size_type __pos) const
3043{
3044    size_type __sz = size();
3045    if (__pos > __sz)
3046        this->__throw_out_of_range();
3047    size_type __rlen = _VSTD::min(__n, __sz - __pos);
3048    traits_type::copy(__s, data() + __pos, __rlen);
3049    return __rlen;
3050}
3051
3052template <class _CharT, class _Traits, class _Allocator>
3053_LIBCPP_INLINE_VISIBILITY inline
3054basic_string<_CharT, _Traits, _Allocator>
3055basic_string<_CharT, _Traits, _Allocator>::substr(size_type __pos, size_type __n) const
3056{
3057    return basic_string(*this, __pos, __n, __alloc());
3058}
3059
3060template <class _CharT, class _Traits, class _Allocator>
3061_LIBCPP_INLINE_VISIBILITY inline
3062void
3063basic_string<_CharT, _Traits, _Allocator>::swap(basic_string& __str)
3064        _NOEXCEPT_(!__alloc_traits::propagate_on_container_swap::value ||
3065                   __is_nothrow_swappable<allocator_type>::value)
3066{
3067    _VSTD::swap(__r_.first(), __str.__r_.first());
3068    __swap_alloc(__alloc(), __str.__alloc());
3069#ifdef _LIBCPP_DEBUG
3070    __invalidate_all_iterators();
3071    __str.__invalidate_all_iterators();
3072#endif  // _LIBCPP_DEBUG
3073}
3074
3075// find
3076
3077template <class _Traits>
3078struct _LIBCPP_HIDDEN __traits_eq
3079{
3080    typedef typename _Traits::char_type char_type;
3081    _LIBCPP_INLINE_VISIBILITY
3082    bool operator()(const char_type& __x, const char_type& __y) _NOEXCEPT
3083        {return _Traits::eq(__x, __y);}
3084};
3085
3086template<class _CharT, class _Traits, class _Allocator>
3087typename basic_string<_CharT, _Traits, _Allocator>::size_type
3088basic_string<_CharT, _Traits, _Allocator>::find(const_pointer __s,
3089                                                size_type __pos,
3090                                                size_type __n) const _NOEXCEPT
3091{
3092#ifdef _LIBCPP_DEBUG
3093    assert(__s != 0);
3094#endif
3095    size_type __sz = size();
3096    if (__pos > __sz || __sz - __pos < __n)
3097        return npos;
3098    if (__n == 0)
3099        return __pos;
3100    const_pointer __p = data();
3101    const_pointer __r = _VSTD::search(__p + __pos, __p + __sz, __s, __s + __n,
3102                                     __traits_eq<traits_type>());
3103    if (__r == __p + __sz)
3104        return npos;
3105    return static_cast<size_type>(__r - __p);
3106}
3107
3108template<class _CharT, class _Traits, class _Allocator>
3109_LIBCPP_INLINE_VISIBILITY inline
3110typename basic_string<_CharT, _Traits, _Allocator>::size_type
3111basic_string<_CharT, _Traits, _Allocator>::find(const basic_string& __str,
3112                                                size_type __pos) const _NOEXCEPT
3113{
3114    return find(__str.data(), __pos, __str.size());
3115}
3116
3117template<class _CharT, class _Traits, class _Allocator>
3118_LIBCPP_INLINE_VISIBILITY inline
3119typename basic_string<_CharT, _Traits, _Allocator>::size_type
3120basic_string<_CharT, _Traits, _Allocator>::find(const_pointer __s,
3121                                                size_type __pos) const _NOEXCEPT
3122{
3123#ifdef _LIBCPP_DEBUG
3124    assert(__s != 0);
3125#endif
3126    return find(__s, __pos, traits_type::length(__s));
3127}
3128
3129template<class _CharT, class _Traits, class _Allocator>
3130typename basic_string<_CharT, _Traits, _Allocator>::size_type
3131basic_string<_CharT, _Traits, _Allocator>::find(value_type __c,
3132                                                size_type __pos) const _NOEXCEPT
3133{
3134    size_type __sz = size();
3135    if (__pos >= __sz)
3136        return npos;
3137    const_pointer __p = data();
3138    const_pointer __r = traits_type::find(__p + __pos, __sz - __pos, __c);
3139    if (__r == 0)
3140        return npos;
3141    return static_cast<size_type>(__r - __p);
3142}
3143
3144// rfind
3145
3146template<class _CharT, class _Traits, class _Allocator>
3147typename basic_string<_CharT, _Traits, _Allocator>::size_type
3148basic_string<_CharT, _Traits, _Allocator>::rfind(const_pointer __s,
3149                                                 size_type __pos,
3150                                                 size_type __n) const _NOEXCEPT
3151{
3152#ifdef _LIBCPP_DEBUG
3153    assert(__s != 0);
3154#endif
3155    size_type __sz = size();
3156    __pos = _VSTD::min(__pos, __sz);
3157    if (__n < __sz - __pos)
3158        __pos += __n;
3159    else
3160        __pos = __sz;
3161    const_pointer __p = data();
3162    const_pointer __r = _VSTD::find_end(__p, __p + __pos, __s, __s + __n,
3163                                       __traits_eq<traits_type>());
3164    if (__n > 0 && __r == __p + __pos)
3165        return npos;
3166    return static_cast<size_type>(__r - __p);
3167}
3168
3169template<class _CharT, class _Traits, class _Allocator>
3170_LIBCPP_INLINE_VISIBILITY inline
3171typename basic_string<_CharT, _Traits, _Allocator>::size_type
3172basic_string<_CharT, _Traits, _Allocator>::rfind(const basic_string& __str,
3173                                                 size_type __pos) const _NOEXCEPT
3174{
3175    return rfind(__str.data(), __pos, __str.size());
3176}
3177
3178template<class _CharT, class _Traits, class _Allocator>
3179_LIBCPP_INLINE_VISIBILITY inline
3180typename basic_string<_CharT, _Traits, _Allocator>::size_type
3181basic_string<_CharT, _Traits, _Allocator>::rfind(const_pointer __s,
3182                                                 size_type __pos) const _NOEXCEPT
3183{
3184#ifdef _LIBCPP_DEBUG
3185    assert(__s != 0);
3186#endif
3187    return rfind(__s, __pos, traits_type::length(__s));
3188}
3189
3190template<class _CharT, class _Traits, class _Allocator>
3191typename basic_string<_CharT, _Traits, _Allocator>::size_type
3192basic_string<_CharT, _Traits, _Allocator>::rfind(value_type __c,
3193                                                 size_type __pos) const _NOEXCEPT
3194{
3195    size_type __sz = size();
3196    if (__sz)
3197    {
3198        if (__pos < __sz)
3199            ++__pos;
3200        else
3201            __pos = __sz;
3202        const_pointer __p = data();
3203        for (const_pointer __ps = __p + __pos; __ps != __p;)
3204        {
3205            if (traits_type::eq(*--__ps, __c))
3206                return static_cast<size_type>(__ps - __p);
3207        }
3208    }
3209    return npos;
3210}
3211
3212// find_first_of
3213
3214template<class _CharT, class _Traits, class _Allocator>
3215typename basic_string<_CharT, _Traits, _Allocator>::size_type
3216basic_string<_CharT, _Traits, _Allocator>::find_first_of(const_pointer __s,
3217                                                         size_type __pos,
3218                                                         size_type __n) const _NOEXCEPT
3219{
3220#ifdef _LIBCPP_DEBUG
3221    assert(__s != 0);
3222#endif
3223    size_type __sz = size();
3224    if (__pos >= __sz || __n == 0)
3225        return npos;
3226    const_pointer __p = data();
3227    const_pointer __r = _VSTD::find_first_of(__p + __pos, __p + __sz, __s,
3228                                            __s + __n, __traits_eq<traits_type>());
3229    if (__r == __p + __sz)
3230        return npos;
3231    return static_cast<size_type>(__r - __p);
3232}
3233
3234template<class _CharT, class _Traits, class _Allocator>
3235_LIBCPP_INLINE_VISIBILITY inline
3236typename basic_string<_CharT, _Traits, _Allocator>::size_type
3237basic_string<_CharT, _Traits, _Allocator>::find_first_of(const basic_string& __str,
3238                                                         size_type __pos) const _NOEXCEPT
3239{
3240    return find_first_of(__str.data(), __pos, __str.size());
3241}
3242
3243template<class _CharT, class _Traits, class _Allocator>
3244_LIBCPP_INLINE_VISIBILITY inline
3245typename basic_string<_CharT, _Traits, _Allocator>::size_type
3246basic_string<_CharT, _Traits, _Allocator>::find_first_of(const_pointer __s,
3247                                                         size_type __pos) const _NOEXCEPT
3248{
3249#ifdef _LIBCPP_DEBUG
3250    assert(__s != 0);
3251#endif
3252    return find_first_of(__s, __pos, traits_type::length(__s));
3253}
3254
3255template<class _CharT, class _Traits, class _Allocator>
3256_LIBCPP_INLINE_VISIBILITY inline
3257typename basic_string<_CharT, _Traits, _Allocator>::size_type
3258basic_string<_CharT, _Traits, _Allocator>::find_first_of(value_type __c,
3259                                                         size_type __pos) const _NOEXCEPT
3260{
3261    return find(__c, __pos);
3262}
3263
3264// find_last_of
3265
3266template<class _CharT, class _Traits, class _Allocator>
3267typename basic_string<_CharT, _Traits, _Allocator>::size_type
3268basic_string<_CharT, _Traits, _Allocator>::find_last_of(const_pointer __s,
3269                                                        size_type __pos,
3270                                                        size_type __n) const _NOEXCEPT
3271{
3272#ifdef _LIBCPP_DEBUG
3273    assert(__s != 0);
3274#endif
3275    if (__n != 0)
3276    {
3277        size_type __sz = size();
3278        if (__pos < __sz)
3279            ++__pos;
3280        else
3281            __pos = __sz;
3282        const_pointer __p = data();
3283        for (const_pointer __ps = __p + __pos; __ps != __p;)
3284        {
3285            const_pointer __r = traits_type::find(__s, __n, *--__ps);
3286            if (__r)
3287                return static_cast<size_type>(__ps - __p);
3288        }
3289    }
3290    return npos;
3291}
3292
3293template<class _CharT, class _Traits, class _Allocator>
3294_LIBCPP_INLINE_VISIBILITY inline
3295typename basic_string<_CharT, _Traits, _Allocator>::size_type
3296basic_string<_CharT, _Traits, _Allocator>::find_last_of(const basic_string& __str,
3297                                                        size_type __pos) const _NOEXCEPT
3298{
3299    return find_last_of(__str.data(), __pos, __str.size());
3300}
3301
3302template<class _CharT, class _Traits, class _Allocator>
3303_LIBCPP_INLINE_VISIBILITY inline
3304typename basic_string<_CharT, _Traits, _Allocator>::size_type
3305basic_string<_CharT, _Traits, _Allocator>::find_last_of(const_pointer __s,
3306                                                        size_type __pos) const _NOEXCEPT
3307{
3308#ifdef _LIBCPP_DEBUG
3309    assert(__s != 0);
3310#endif
3311    return find_last_of(__s, __pos, traits_type::length(__s));
3312}
3313
3314template<class _CharT, class _Traits, class _Allocator>
3315_LIBCPP_INLINE_VISIBILITY inline
3316typename basic_string<_CharT, _Traits, _Allocator>::size_type
3317basic_string<_CharT, _Traits, _Allocator>::find_last_of(value_type __c,
3318                                                        size_type __pos) const _NOEXCEPT
3319{
3320    return rfind(__c, __pos);
3321}
3322
3323// find_first_not_of
3324
3325template<class _CharT, class _Traits, class _Allocator>
3326typename basic_string<_CharT, _Traits, _Allocator>::size_type
3327basic_string<_CharT, _Traits, _Allocator>::find_first_not_of(const_pointer __s,
3328                                                             size_type __pos,
3329                                                             size_type __n) const _NOEXCEPT
3330{
3331#ifdef _LIBCPP_DEBUG
3332    assert(__s != 0);
3333#endif
3334    size_type __sz = size();
3335    if (__pos < __sz)
3336    {
3337        const_pointer __p = data();
3338        const_pointer __pe = __p + __sz;
3339        for (const_pointer __ps = __p + __pos; __ps != __pe; ++__ps)
3340            if (traits_type::find(__s, __n, *__ps) == 0)
3341                return static_cast<size_type>(__ps - __p);
3342    }
3343    return npos;
3344}
3345
3346template<class _CharT, class _Traits, class _Allocator>
3347_LIBCPP_INLINE_VISIBILITY inline
3348typename basic_string<_CharT, _Traits, _Allocator>::size_type
3349basic_string<_CharT, _Traits, _Allocator>::find_first_not_of(const basic_string& __str,
3350                                                             size_type __pos) const _NOEXCEPT
3351{
3352    return find_first_not_of(__str.data(), __pos, __str.size());
3353}
3354
3355template<class _CharT, class _Traits, class _Allocator>
3356_LIBCPP_INLINE_VISIBILITY inline
3357typename basic_string<_CharT, _Traits, _Allocator>::size_type
3358basic_string<_CharT, _Traits, _Allocator>::find_first_not_of(const_pointer __s,
3359                                                             size_type __pos) const _NOEXCEPT
3360{
3361#ifdef _LIBCPP_DEBUG
3362    assert(__s != 0);
3363#endif
3364    return find_first_not_of(__s, __pos, traits_type::length(__s));
3365}
3366
3367template<class _CharT, class _Traits, class _Allocator>
3368_LIBCPP_INLINE_VISIBILITY inline
3369typename basic_string<_CharT, _Traits, _Allocator>::size_type
3370basic_string<_CharT, _Traits, _Allocator>::find_first_not_of(value_type __c,
3371                                                             size_type __pos) const _NOEXCEPT
3372{
3373    size_type __sz = size();
3374    if (__pos < __sz)
3375    {
3376        const_pointer __p = data();
3377        const_pointer __pe = __p + __sz;
3378        for (const_pointer __ps = __p + __pos; __ps != __pe; ++__ps)
3379            if (!traits_type::eq(*__ps, __c))
3380                return static_cast<size_type>(__ps - __p);
3381    }
3382    return npos;
3383}
3384
3385// find_last_not_of
3386
3387template<class _CharT, class _Traits, class _Allocator>
3388typename basic_string<_CharT, _Traits, _Allocator>::size_type
3389basic_string<_CharT, _Traits, _Allocator>::find_last_not_of(const_pointer __s,
3390                                                            size_type __pos,
3391                                                            size_type __n) const _NOEXCEPT
3392{
3393#ifdef _LIBCPP_DEBUG
3394    assert(__s != 0);
3395#endif
3396    size_type __sz = size();
3397    if (__pos < __sz)
3398        ++__pos;
3399    else
3400        __pos = __sz;
3401    const_pointer __p = data();
3402    for (const_pointer __ps = __p + __pos; __ps != __p;)
3403        if (traits_type::find(__s, __n, *--__ps) == 0)
3404            return static_cast<size_type>(__ps - __p);
3405    return npos;
3406}
3407
3408template<class _CharT, class _Traits, class _Allocator>
3409_LIBCPP_INLINE_VISIBILITY inline
3410typename basic_string<_CharT, _Traits, _Allocator>::size_type
3411basic_string<_CharT, _Traits, _Allocator>::find_last_not_of(const basic_string& __str,
3412                                                            size_type __pos) const _NOEXCEPT
3413{
3414    return find_last_not_of(__str.data(), __pos, __str.size());
3415}
3416
3417template<class _CharT, class _Traits, class _Allocator>
3418_LIBCPP_INLINE_VISIBILITY inline
3419typename basic_string<_CharT, _Traits, _Allocator>::size_type
3420basic_string<_CharT, _Traits, _Allocator>::find_last_not_of(const_pointer __s,
3421                                                            size_type __pos) const _NOEXCEPT
3422{
3423#ifdef _LIBCPP_DEBUG
3424    assert(__s != 0);
3425#endif
3426    return find_last_not_of(__s, __pos, traits_type::length(__s));
3427}
3428
3429template<class _CharT, class _Traits, class _Allocator>
3430_LIBCPP_INLINE_VISIBILITY inline
3431typename basic_string<_CharT, _Traits, _Allocator>::size_type
3432basic_string<_CharT, _Traits, _Allocator>::find_last_not_of(value_type __c,
3433                                                            size_type __pos) const _NOEXCEPT
3434{
3435    size_type __sz = size();
3436    if (__pos < __sz)
3437        ++__pos;
3438    else
3439        __pos = __sz;
3440    const_pointer __p = data();
3441    for (const_pointer __ps = __p + __pos; __ps != __p;)
3442        if (!traits_type::eq(*--__ps, __c))
3443            return static_cast<size_type>(__ps - __p);
3444    return npos;
3445}
3446
3447// compare
3448
3449template <class _CharT, class _Traits, class _Allocator>
3450_LIBCPP_INLINE_VISIBILITY inline
3451int
3452basic_string<_CharT, _Traits, _Allocator>::compare(const basic_string& __str) const _NOEXCEPT
3453{
3454    size_t __lhs_sz = size();
3455    size_t __rhs_sz = __str.size();
3456    int __result = traits_type::compare(data(), __str.data(),
3457                                        _VSTD::min(__lhs_sz, __rhs_sz));
3458    if (__result != 0)
3459        return __result;
3460    if (__lhs_sz < __rhs_sz)
3461        return -1;
3462    if (__lhs_sz > __rhs_sz)
3463        return 1;
3464    return 0;
3465}
3466
3467template <class _CharT, class _Traits, class _Allocator>
3468_LIBCPP_INLINE_VISIBILITY inline
3469int
3470basic_string<_CharT, _Traits, _Allocator>::compare(size_type __pos1,
3471                                                   size_type __n1,
3472                                                   const basic_string& __str) const
3473{
3474    return compare(__pos1, __n1, __str.data(), __str.size());
3475}
3476
3477template <class _CharT, class _Traits, class _Allocator>
3478int
3479basic_string<_CharT, _Traits, _Allocator>::compare(size_type __pos1,
3480                                                   size_type __n1,
3481                                                   const basic_string& __str,
3482                                                   size_type __pos2,
3483                                                   size_type __n2) const
3484{
3485    size_type __sz = __str.size();
3486    if (__pos2 > __sz)
3487        this->__throw_out_of_range();
3488    return compare(__pos1, __n1, __str.data() + __pos2, _VSTD::min(__n2,
3489                                                                  __sz - __pos2));
3490}
3491
3492template <class _CharT, class _Traits, class _Allocator>
3493int
3494basic_string<_CharT, _Traits, _Allocator>::compare(const_pointer __s) const _NOEXCEPT
3495{
3496#ifdef _LIBCPP_DEBUG
3497    assert(__s != 0);
3498#endif
3499    return compare(0, npos, __s, traits_type::length(__s));
3500}
3501
3502template <class _CharT, class _Traits, class _Allocator>
3503int
3504basic_string<_CharT, _Traits, _Allocator>::compare(size_type __pos1,
3505                                                   size_type __n1,
3506                                                   const_pointer __s) const
3507{
3508#ifdef _LIBCPP_DEBUG
3509    assert(__s != 0);
3510#endif
3511    return compare(__pos1, __n1, __s, traits_type::length(__s));
3512}
3513
3514template <class _CharT, class _Traits, class _Allocator>
3515int
3516basic_string<_CharT, _Traits, _Allocator>::compare(size_type __pos1,
3517                                                   size_type __n1,
3518                                                   const_pointer __s,
3519                                                   size_type __n2) const
3520{
3521#ifdef _LIBCPP_DEBUG
3522    assert(__s != 0);
3523#endif
3524    size_type __sz = size();
3525    if (__pos1 > __sz || __n2 == npos)
3526        this->__throw_out_of_range();
3527    size_type __rlen = _VSTD::min(__n1, __sz - __pos1);
3528    int __r = traits_type::compare(data() + __pos1, __s, _VSTD::min(__rlen, __n2));
3529    if (__r == 0)
3530    {
3531        if (__rlen < __n2)
3532            __r = -1;
3533        else if (__rlen > __n2)
3534            __r = 1;
3535    }
3536    return __r;
3537}
3538
3539// __invariants
3540
3541template<class _CharT, class _Traits, class _Allocator>
3542_LIBCPP_INLINE_VISIBILITY inline
3543bool
3544basic_string<_CharT, _Traits, _Allocator>::__invariants() const
3545{
3546    if (size() > capacity())
3547        return false;
3548    if (capacity() < __min_cap - 1)
3549        return false;
3550    if (data() == 0)
3551        return false;
3552    if (data()[size()] != value_type(0))
3553        return false;
3554    return true;
3555}
3556
3557// operator==
3558
3559template<class _CharT, class _Traits, class _Allocator>
3560_LIBCPP_INLINE_VISIBILITY inline
3561bool
3562operator==(const basic_string<_CharT, _Traits, _Allocator>& __lhs,
3563           const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
3564{
3565    size_t __lhs_sz = __lhs.size();
3566    return __lhs_sz == __rhs.size() && _Traits::compare(__lhs.data(),
3567                                                        __rhs.data(),
3568                                                        __lhs_sz) == 0;
3569}
3570
3571template<class _Allocator>
3572_LIBCPP_INLINE_VISIBILITY inline
3573bool
3574operator==(const basic_string<char, char_traits<char>, _Allocator>& __lhs,
3575           const basic_string<char, char_traits<char>, _Allocator>& __rhs) _NOEXCEPT
3576{
3577    size_t __lhs_sz = __lhs.size();
3578    if (__lhs_sz != __rhs.size())
3579        return false;
3580    const char* __lp = __lhs.data();
3581    const char* __rp = __rhs.data();
3582    if (__lhs.__is_long())
3583        return char_traits<char>::compare(__lp, __rp, __lhs_sz) == 0;
3584    for (; __lhs_sz != 0; --__lhs_sz, ++__lp, ++__rp)
3585        if (*__lp != *__rp)
3586            return false;
3587    return true;
3588}
3589
3590template<class _CharT, class _Traits, class _Allocator>
3591_LIBCPP_INLINE_VISIBILITY inline
3592bool
3593operator==(const _CharT* __lhs,
3594           const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
3595{
3596    return __rhs.compare(__lhs) == 0;
3597}
3598
3599template<class _CharT, class _Traits, class _Allocator>
3600_LIBCPP_INLINE_VISIBILITY inline
3601bool
3602operator==(const basic_string<_CharT,_Traits,_Allocator>& __lhs,
3603           const _CharT* __rhs) _NOEXCEPT
3604{
3605    return __lhs.compare(__rhs) == 0;
3606}
3607
3608// operator!=
3609
3610template<class _CharT, class _Traits, class _Allocator>
3611_LIBCPP_INLINE_VISIBILITY inline
3612bool
3613operator!=(const basic_string<_CharT,_Traits,_Allocator>& __lhs,
3614           const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
3615{
3616    return !(__lhs == __rhs);
3617}
3618
3619template<class _CharT, class _Traits, class _Allocator>
3620_LIBCPP_INLINE_VISIBILITY inline
3621bool
3622operator!=(const _CharT* __lhs,
3623           const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
3624{
3625    return !(__lhs == __rhs);
3626}
3627
3628template<class _CharT, class _Traits, class _Allocator>
3629_LIBCPP_INLINE_VISIBILITY inline
3630bool
3631operator!=(const basic_string<_CharT, _Traits, _Allocator>& __lhs,
3632           const _CharT* __rhs) _NOEXCEPT
3633{
3634    return !(__lhs == __rhs);
3635}
3636
3637// operator<
3638
3639template<class _CharT, class _Traits, class _Allocator>
3640_LIBCPP_INLINE_VISIBILITY inline
3641bool
3642operator< (const basic_string<_CharT, _Traits, _Allocator>& __lhs,
3643           const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
3644{
3645    return __lhs.compare(__rhs) < 0;
3646}
3647
3648template<class _CharT, class _Traits, class _Allocator>
3649_LIBCPP_INLINE_VISIBILITY inline
3650bool
3651operator< (const basic_string<_CharT, _Traits, _Allocator>& __lhs,
3652           const _CharT* __rhs) _NOEXCEPT
3653{
3654    return __lhs.compare(__rhs) < 0;
3655}
3656
3657template<class _CharT, class _Traits, class _Allocator>
3658_LIBCPP_INLINE_VISIBILITY inline
3659bool
3660operator< (const _CharT* __lhs,
3661           const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
3662{
3663    return __rhs.compare(__lhs) > 0;
3664}
3665
3666// operator>
3667
3668template<class _CharT, class _Traits, class _Allocator>
3669_LIBCPP_INLINE_VISIBILITY inline
3670bool
3671operator> (const basic_string<_CharT, _Traits, _Allocator>& __lhs,
3672           const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
3673{
3674    return __rhs < __lhs;
3675}
3676
3677template<class _CharT, class _Traits, class _Allocator>
3678_LIBCPP_INLINE_VISIBILITY inline
3679bool
3680operator> (const basic_string<_CharT, _Traits, _Allocator>& __lhs,
3681           const _CharT* __rhs) _NOEXCEPT
3682{
3683    return __rhs < __lhs;
3684}
3685
3686template<class _CharT, class _Traits, class _Allocator>
3687_LIBCPP_INLINE_VISIBILITY inline
3688bool
3689operator> (const _CharT* __lhs,
3690           const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
3691{
3692    return __rhs < __lhs;
3693}
3694
3695// operator<=
3696
3697template<class _CharT, class _Traits, class _Allocator>
3698_LIBCPP_INLINE_VISIBILITY inline
3699bool
3700operator<=(const basic_string<_CharT, _Traits, _Allocator>& __lhs,
3701           const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
3702{
3703    return !(__rhs < __lhs);
3704}
3705
3706template<class _CharT, class _Traits, class _Allocator>
3707_LIBCPP_INLINE_VISIBILITY inline
3708bool
3709operator<=(const basic_string<_CharT, _Traits, _Allocator>& __lhs,
3710           const _CharT* __rhs) _NOEXCEPT
3711{
3712    return !(__rhs < __lhs);
3713}
3714
3715template<class _CharT, class _Traits, class _Allocator>
3716_LIBCPP_INLINE_VISIBILITY inline
3717bool
3718operator<=(const _CharT* __lhs,
3719           const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
3720{
3721    return !(__rhs < __lhs);
3722}
3723
3724// operator>=
3725
3726template<class _CharT, class _Traits, class _Allocator>
3727_LIBCPP_INLINE_VISIBILITY inline
3728bool
3729operator>=(const basic_string<_CharT, _Traits, _Allocator>& __lhs,
3730           const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
3731{
3732    return !(__lhs < __rhs);
3733}
3734
3735template<class _CharT, class _Traits, class _Allocator>
3736_LIBCPP_INLINE_VISIBILITY inline
3737bool
3738operator>=(const basic_string<_CharT, _Traits, _Allocator>& __lhs,
3739           const _CharT* __rhs) _NOEXCEPT
3740{
3741    return !(__lhs < __rhs);
3742}
3743
3744template<class _CharT, class _Traits, class _Allocator>
3745_LIBCPP_INLINE_VISIBILITY inline
3746bool
3747operator>=(const _CharT* __lhs,
3748           const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
3749{
3750    return !(__lhs < __rhs);
3751}
3752
3753// operator +
3754
3755template<class _CharT, class _Traits, class _Allocator>
3756basic_string<_CharT, _Traits, _Allocator>
3757operator+(const basic_string<_CharT, _Traits, _Allocator>& __lhs,
3758          const basic_string<_CharT, _Traits, _Allocator>& __rhs)
3759{
3760    basic_string<_CharT, _Traits, _Allocator> __r(__lhs.get_allocator());
3761    typename basic_string<_CharT, _Traits, _Allocator>::size_type __lhs_sz = __lhs.size();
3762    typename basic_string<_CharT, _Traits, _Allocator>::size_type __rhs_sz = __rhs.size();
3763    __r.__init(__lhs.data(), __lhs_sz, __lhs_sz + __rhs_sz);
3764    __r.append(__rhs.data(), __rhs_sz);
3765    return __r;
3766}
3767
3768template<class _CharT, class _Traits, class _Allocator>
3769basic_string<_CharT, _Traits, _Allocator>
3770operator+(const _CharT* __lhs , const basic_string<_CharT,_Traits,_Allocator>& __rhs)
3771{
3772    basic_string<_CharT, _Traits, _Allocator> __r(__rhs.get_allocator());
3773    typename basic_string<_CharT, _Traits, _Allocator>::size_type __lhs_sz = _Traits::length(__lhs);
3774    typename basic_string<_CharT, _Traits, _Allocator>::size_type __rhs_sz = __rhs.size();
3775    __r.__init(__lhs, __lhs_sz, __lhs_sz + __rhs_sz);
3776    __r.append(__rhs.data(), __rhs_sz);
3777    return __r;
3778}
3779
3780template<class _CharT, class _Traits, class _Allocator>
3781basic_string<_CharT, _Traits, _Allocator>
3782operator+(_CharT __lhs, const basic_string<_CharT,_Traits,_Allocator>& __rhs)
3783{
3784    basic_string<_CharT, _Traits, _Allocator> __r(__rhs.get_allocator());
3785    typename basic_string<_CharT, _Traits, _Allocator>::size_type __rhs_sz = __rhs.size();
3786    __r.__init(&__lhs, 1, 1 + __rhs_sz);
3787    __r.append(__rhs.data(), __rhs_sz);
3788    return __r;
3789}
3790
3791template<class _CharT, class _Traits, class _Allocator>
3792basic_string<_CharT, _Traits, _Allocator>
3793operator+(const basic_string<_CharT, _Traits, _Allocator>& __lhs, const _CharT* __rhs)
3794{
3795    basic_string<_CharT, _Traits, _Allocator> __r(__lhs.get_allocator());
3796    typename basic_string<_CharT, _Traits, _Allocator>::size_type __lhs_sz = __lhs.size();
3797    typename basic_string<_CharT, _Traits, _Allocator>::size_type __rhs_sz = _Traits::length(__rhs);
3798    __r.__init(__lhs.data(), __lhs_sz, __lhs_sz + __rhs_sz);
3799    __r.append(__rhs, __rhs_sz);
3800    return __r;
3801}
3802
3803template<class _CharT, class _Traits, class _Allocator>
3804basic_string<_CharT, _Traits, _Allocator>
3805operator+(const basic_string<_CharT, _Traits, _Allocator>& __lhs, _CharT __rhs)
3806{
3807    basic_string<_CharT, _Traits, _Allocator> __r(__lhs.get_allocator());
3808    typename basic_string<_CharT, _Traits, _Allocator>::size_type __lhs_sz = __lhs.size();
3809    __r.__init(__lhs.data(), __lhs_sz, __lhs_sz + 1);
3810    __r.push_back(__rhs);
3811    return __r;
3812}
3813
3814#ifndef _LIBCPP_HAS_NO_RVALUE_REFERENCES
3815
3816template<class _CharT, class _Traits, class _Allocator>
3817_LIBCPP_INLINE_VISIBILITY inline
3818basic_string<_CharT, _Traits, _Allocator>
3819operator+(basic_string<_CharT, _Traits, _Allocator>&& __lhs, const basic_string<_CharT, _Traits, _Allocator>& __rhs)
3820{
3821    return _VSTD::move(__lhs.append(__rhs));
3822}
3823
3824template<class _CharT, class _Traits, class _Allocator>
3825_LIBCPP_INLINE_VISIBILITY inline
3826basic_string<_CharT, _Traits, _Allocator>
3827operator+(const basic_string<_CharT, _Traits, _Allocator>& __lhs, basic_string<_CharT, _Traits, _Allocator>&& __rhs)
3828{
3829    return _VSTD::move(__rhs.insert(0, __lhs));
3830}
3831
3832template<class _CharT, class _Traits, class _Allocator>
3833_LIBCPP_INLINE_VISIBILITY inline
3834basic_string<_CharT, _Traits, _Allocator>
3835operator+(basic_string<_CharT, _Traits, _Allocator>&& __lhs, basic_string<_CharT, _Traits, _Allocator>&& __rhs)
3836{
3837    return _VSTD::move(__lhs.append(__rhs));
3838}
3839
3840template<class _CharT, class _Traits, class _Allocator>
3841_LIBCPP_INLINE_VISIBILITY inline
3842basic_string<_CharT, _Traits, _Allocator>
3843operator+(const _CharT* __lhs , basic_string<_CharT,_Traits,_Allocator>&& __rhs)
3844{
3845    return _VSTD::move(__rhs.insert(0, __lhs));
3846}
3847
3848template<class _CharT, class _Traits, class _Allocator>
3849_LIBCPP_INLINE_VISIBILITY inline
3850basic_string<_CharT, _Traits, _Allocator>
3851operator+(_CharT __lhs, basic_string<_CharT,_Traits,_Allocator>&& __rhs)
3852{
3853    __rhs.insert(__rhs.begin(), __lhs);
3854    return _VSTD::move(__rhs);
3855}
3856
3857template<class _CharT, class _Traits, class _Allocator>
3858_LIBCPP_INLINE_VISIBILITY inline
3859basic_string<_CharT, _Traits, _Allocator>
3860operator+(basic_string<_CharT, _Traits, _Allocator>&& __lhs, const _CharT* __rhs)
3861{
3862    return _VSTD::move(__lhs.append(__rhs));
3863}
3864
3865template<class _CharT, class _Traits, class _Allocator>
3866_LIBCPP_INLINE_VISIBILITY inline
3867basic_string<_CharT, _Traits, _Allocator>
3868operator+(basic_string<_CharT, _Traits, _Allocator>&& __lhs, _CharT __rhs)
3869{
3870    __lhs.push_back(__rhs);
3871    return _VSTD::move(__lhs);
3872}
3873
3874#endif  // _LIBCPP_HAS_NO_RVALUE_REFERENCES
3875
3876// swap
3877
3878template<class _CharT, class _Traits, class _Allocator>
3879_LIBCPP_INLINE_VISIBILITY inline
3880void
3881swap(basic_string<_CharT, _Traits, _Allocator>& __lhs,
3882     basic_string<_CharT, _Traits, _Allocator>& __rhs)
3883     _NOEXCEPT_(_NOEXCEPT_(__lhs.swap(__rhs)))
3884{
3885    __lhs.swap(__rhs);
3886}
3887
3888#ifndef _LIBCPP_HAS_NO_UNICODE_CHARS
3889
3890typedef basic_string<char16_t> u16string;
3891typedef basic_string<char32_t> u32string;
3892
3893#endif  // _LIBCPP_HAS_NO_UNICODE_CHARS
3894
3895int                stoi  (const string& __str, size_t* __idx = 0, int __base = 10);
3896long               stol  (const string& __str, size_t* __idx = 0, int __base = 10);
3897unsigned long      stoul (const string& __str, size_t* __idx = 0, int __base = 10);
3898long long          stoll (const string& __str, size_t* __idx = 0, int __base = 10);
3899unsigned long long stoull(const string& __str, size_t* __idx = 0, int __base = 10);
3900
3901float       stof (const string& __str, size_t* __idx = 0);
3902double      stod (const string& __str, size_t* __idx = 0);
3903long double stold(const string& __str, size_t* __idx = 0);
3904
3905string to_string(int __val);
3906string to_string(unsigned __val);
3907string to_string(long __val);
3908string to_string(unsigned long __val);
3909string to_string(long long __val);
3910string to_string(unsigned long long __val);
3911string to_string(float __val);
3912string to_string(double __val);
3913string to_string(long double __val);
3914
3915int                stoi  (const wstring& __str, size_t* __idx = 0, int __base = 10);
3916long               stol  (const wstring& __str, size_t* __idx = 0, int __base = 10);
3917unsigned long      stoul (const wstring& __str, size_t* __idx = 0, int __base = 10);
3918long long          stoll (const wstring& __str, size_t* __idx = 0, int __base = 10);
3919unsigned long long stoull(const wstring& __str, size_t* __idx = 0, int __base = 10);
3920
3921float       stof (const wstring& __str, size_t* __idx = 0);
3922double      stod (const wstring& __str, size_t* __idx = 0);
3923long double stold(const wstring& __str, size_t* __idx = 0);
3924
3925wstring to_wstring(int __val);
3926wstring to_wstring(unsigned __val);
3927wstring to_wstring(long __val);
3928wstring to_wstring(unsigned long __val);
3929wstring to_wstring(long long __val);
3930wstring to_wstring(unsigned long long __val);
3931wstring to_wstring(float __val);
3932wstring to_wstring(double __val);
3933wstring to_wstring(long double __val);
3934
3935template<class _CharT, class _Traits, class _Allocator>
3936    const typename basic_string<_CharT, _Traits, _Allocator>::size_type
3937                   basic_string<_CharT, _Traits, _Allocator>::npos;
3938
3939template<class _Ptr>
3940size_t _LIBCPP_INLINE_VISIBILITY __do_string_hash(_Ptr __p, _Ptr __e)
3941{
3942    typedef typename iterator_traits<_Ptr>::value_type value_type;
3943    return __murmur2_or_cityhash<size_t>()(__p, (__e-__p)*sizeof(value_type));
3944}
3945
3946template<class _CharT, class _Traits, class _Allocator>
3947struct _LIBCPP_TYPE_VIS hash<basic_string<_CharT, _Traits, _Allocator> >
3948    : public unary_function<basic_string<_CharT, _Traits, _Allocator>, size_t>
3949{
3950    size_t
3951        operator()(const basic_string<_CharT, _Traits, _Allocator>& __val) const _NOEXCEPT;
3952};
3953
3954template<class _CharT, class _Traits, class _Allocator>
3955size_t
3956hash<basic_string<_CharT, _Traits, _Allocator> >::operator()(
3957        const basic_string<_CharT, _Traits, _Allocator>& __val) const _NOEXCEPT
3958{
3959    return __do_string_hash(__val.data(), __val.data() + __val.size());
3960}
3961
3962template<class _CharT, class _Traits, class _Allocator>
3963basic_ostream<_CharT, _Traits>&
3964operator<<(basic_ostream<_CharT, _Traits>& __os,
3965           const basic_string<_CharT, _Traits, _Allocator>& __str);
3966
3967template<class _CharT, class _Traits, class _Allocator>
3968basic_istream<_CharT, _Traits>&
3969operator>>(basic_istream<_CharT, _Traits>& __is,
3970           basic_string<_CharT, _Traits, _Allocator>& __str);
3971
3972template<class _CharT, class _Traits, class _Allocator>
3973basic_istream<_CharT, _Traits>&
3974getline(basic_istream<_CharT, _Traits>& __is,
3975        basic_string<_CharT, _Traits, _Allocator>& __str, _CharT __dlm);
3976
3977template<class _CharT, class _Traits, class _Allocator>
3978inline _LIBCPP_INLINE_VISIBILITY
3979basic_istream<_CharT, _Traits>&
3980getline(basic_istream<_CharT, _Traits>& __is,
3981        basic_string<_CharT, _Traits, _Allocator>& __str);
3982
3983#ifndef _LIBCPP_HAS_NO_RVALUE_REFERENCES
3984
3985template<class _CharT, class _Traits, class _Allocator>
3986inline _LIBCPP_INLINE_VISIBILITY
3987basic_istream<_CharT, _Traits>&
3988getline(basic_istream<_CharT, _Traits>&& __is,
3989        basic_string<_CharT, _Traits, _Allocator>& __str, _CharT __dlm);
3990
3991template<class _CharT, class _Traits, class _Allocator>
3992inline _LIBCPP_INLINE_VISIBILITY
3993basic_istream<_CharT, _Traits>&
3994getline(basic_istream<_CharT, _Traits>&& __is,
3995        basic_string<_CharT, _Traits, _Allocator>& __str);
3996
3997#endif  // _LIBCPP_HAS_NO_RVALUE_REFERENCES
3998
3999_LIBCPP_EXTERN_TEMPLATE(class basic_string<char>)
4000_LIBCPP_EXTERN_TEMPLATE(class basic_string<wchar_t>)
4001
4002extern template
4003    string
4004    operator+<char, char_traits<char>, allocator<char> >(char const*, string const&);
4005
4006_LIBCPP_END_NAMESPACE_STD
4007
4008#endif  // _LIBCPP_STRING
4009