blob: 4940021b0c68a7e45297a671c13ec44839a9bfa3 [file] [log] [blame]
Howard Hinnantc51e1022010-05-11 19:42:16 +00001// -*- C++ -*-
2//===--------------------------- string -----------------------------------===//
3//
Chandler Carruth7642bb12019-01-19 08:50:56 +00004// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
5// See https://llvm.org/LICENSE.txt for license information.
6// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
Howard Hinnantc51e1022010-05-11 19:42:16 +00007//
8//===----------------------------------------------------------------------===//
9
10#ifndef _LIBCPP_STRING
11#define _LIBCPP_STRING
12
13/*
14 string synopsis
15
16namespace std
17{
18
19template <class stateT>
20class fpos
21{
22private:
23 stateT st;
24public:
25 fpos(streamoff = streamoff());
26
27 operator streamoff() const;
28
29 stateT state() const;
30 void state(stateT);
31
32 fpos& operator+=(streamoff);
33 fpos operator+ (streamoff) const;
34 fpos& operator-=(streamoff);
35 fpos operator- (streamoff) const;
36};
37
38template <class stateT> streamoff operator-(const fpos<stateT>& x, const fpos<stateT>& y);
39
40template <class stateT> bool operator==(const fpos<stateT>& x, const fpos<stateT>& y);
41template <class stateT> bool operator!=(const fpos<stateT>& x, const fpos<stateT>& y);
42
43template <class charT>
44struct char_traits
45{
46 typedef charT char_type;
47 typedef ... int_type;
48 typedef streamoff off_type;
49 typedef streampos pos_type;
50 typedef mbstate_t state_type;
51
Howard Hinnantaeb17d82011-05-29 19:57:12 +000052 static void assign(char_type& c1, const char_type& c2) noexcept;
Howard Hinnant270c00e2012-07-20 19:09:12 +000053 static constexpr bool eq(char_type c1, char_type c2) noexcept;
54 static constexpr bool lt(char_type c1, char_type c2) noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +000055
56 static int compare(const char_type* s1, const char_type* s2, size_t n);
57 static size_t length(const char_type* s);
58 static const char_type* find(const char_type* s, size_t n, const char_type& a);
59 static char_type* move(char_type* s1, const char_type* s2, size_t n);
60 static char_type* copy(char_type* s1, const char_type* s2, size_t n);
61 static char_type* assign(char_type* s, size_t n, char_type a);
62
Howard Hinnant270c00e2012-07-20 19:09:12 +000063 static constexpr int_type not_eof(int_type c) noexcept;
64 static constexpr char_type to_char_type(int_type c) noexcept;
65 static constexpr int_type to_int_type(char_type c) noexcept;
66 static constexpr bool eq_int_type(int_type c1, int_type c2) noexcept;
67 static constexpr int_type eof() noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +000068};
69
70template <> struct char_traits<char>;
71template <> struct char_traits<wchar_t>;
Marek Kurdeje3ac4e22021-03-23 17:15:07 +010072template <> struct char_traits<char8_t>; // C++20
73template <> struct char_traits<char16_t>;
74template <> struct char_traits<char32_t>;
Howard Hinnantc51e1022010-05-11 19:42:16 +000075
Howard Hinnant3b6579a2010-08-22 00:02:43 +000076template<class charT, class traits = char_traits<charT>, class Allocator = allocator<charT> >
Howard Hinnantc51e1022010-05-11 19:42:16 +000077class basic_string
78{
Howard Hinnant3b6579a2010-08-22 00:02:43 +000079public:
80// types:
Howard Hinnantc51e1022010-05-11 19:42:16 +000081 typedef traits traits_type;
82 typedef typename traits_type::char_type value_type;
83 typedef Allocator allocator_type;
84 typedef typename allocator_type::size_type size_type;
85 typedef typename allocator_type::difference_type difference_type;
86 typedef typename allocator_type::reference reference;
87 typedef typename allocator_type::const_reference const_reference;
88 typedef typename allocator_type::pointer pointer;
89 typedef typename allocator_type::const_pointer const_pointer;
90 typedef implementation-defined iterator;
91 typedef implementation-defined const_iterator;
92 typedef std::reverse_iterator<iterator> reverse_iterator;
93 typedef std::reverse_iterator<const_iterator> const_reverse_iterator;
94
95 static const size_type npos = -1;
96
Howard Hinnant3e276872011-06-03 18:40:47 +000097 basic_string()
98 noexcept(is_nothrow_default_constructible<allocator_type>::value);
99 explicit basic_string(const allocator_type& a);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000100 basic_string(const basic_string& str);
Howard Hinnant3e276872011-06-03 18:40:47 +0000101 basic_string(basic_string&& str)
102 noexcept(is_nothrow_move_constructible<allocator_type>::value);
Marshall Clow83445802016-04-07 18:13:41 +0000103 basic_string(const basic_string& str, size_type pos,
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000104 const allocator_type& a = allocator_type());
Marshall Clow83445802016-04-07 18:13:41 +0000105 basic_string(const basic_string& str, size_type pos, size_type n,
Marshall Clowdf63a6d2016-07-21 05:31:24 +0000106 const Allocator& a = Allocator());
Marshall Clow78dbe462016-11-14 18:22:19 +0000107 template<class T>
108 basic_string(const T& t, size_type pos, size_type n, const Allocator& a = Allocator()); // C++17
Marshall Clowe46031a2018-07-02 18:41:15 +0000109 template <class T>
110 explicit basic_string(const T& t, const Allocator& a = Allocator()); // C++17
Howard Hinnantd17880b2013-06-28 16:59:19 +0000111 basic_string(const value_type* s, const allocator_type& a = allocator_type());
112 basic_string(const value_type* s, size_type n, const allocator_type& a = allocator_type());
Marek Kurdej90d79712021-07-27 16:16:21 +0200113 basic_string(nullptr_t) = delete; // C++2b
Howard Hinnantc51e1022010-05-11 19:42:16 +0000114 basic_string(size_type n, value_type c, const allocator_type& a = allocator_type());
115 template<class InputIterator>
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000116 basic_string(InputIterator begin, InputIterator end,
117 const allocator_type& a = allocator_type());
Howard Hinnantc51e1022010-05-11 19:42:16 +0000118 basic_string(initializer_list<value_type>, const Allocator& = Allocator());
119 basic_string(const basic_string&, const Allocator&);
120 basic_string(basic_string&&, const Allocator&);
121
122 ~basic_string();
123
Marshall Clowdf63a6d2016-07-21 05:31:24 +0000124 operator basic_string_view<charT, traits>() const noexcept;
125
Howard Hinnantc51e1022010-05-11 19:42:16 +0000126 basic_string& operator=(const basic_string& str);
Marshall Clowe46031a2018-07-02 18:41:15 +0000127 template <class T>
128 basic_string& operator=(const T& t); // C++17
Howard Hinnant3e276872011-06-03 18:40:47 +0000129 basic_string& operator=(basic_string&& str)
130 noexcept(
Marshall Clow2fe8a8d2015-08-18 18:57:00 +0000131 allocator_type::propagate_on_container_move_assignment::value ||
132 allocator_type::is_always_equal::value ); // C++17
Howard Hinnantd17880b2013-06-28 16:59:19 +0000133 basic_string& operator=(const value_type* s);
Marek Kurdej90d79712021-07-27 16:16:21 +0200134 basic_string& operator=(nullptr_t) = delete; // C++2b
Howard Hinnantc51e1022010-05-11 19:42:16 +0000135 basic_string& operator=(value_type c);
136 basic_string& operator=(initializer_list<value_type>);
137
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000138 iterator begin() noexcept;
139 const_iterator begin() const noexcept;
140 iterator end() noexcept;
141 const_iterator end() const noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000142
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000143 reverse_iterator rbegin() noexcept;
144 const_reverse_iterator rbegin() const noexcept;
145 reverse_iterator rend() noexcept;
146 const_reverse_iterator rend() const noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000147
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000148 const_iterator cbegin() const noexcept;
149 const_iterator cend() const noexcept;
150 const_reverse_iterator crbegin() const noexcept;
151 const_reverse_iterator crend() const noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000152
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000153 size_type size() const noexcept;
154 size_type length() const noexcept;
155 size_type max_size() const noexcept;
156 size_type capacity() const noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000157
158 void resize(size_type n, value_type c);
159 void resize(size_type n);
160
Marek Kurdejc9848142020-11-26 10:07:16 +0100161 void reserve(size_type res_arg);
162 void reserve(); // deprecated in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000163 void shrink_to_fit();
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000164 void clear() noexcept;
165 bool empty() const noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000166
167 const_reference operator[](size_type pos) const;
168 reference operator[](size_type pos);
169
170 const_reference at(size_type n) const;
171 reference at(size_type n);
172
173 basic_string& operator+=(const basic_string& str);
Marshall Clowe46031a2018-07-02 18:41:15 +0000174 template <class T>
175 basic_string& operator+=(const T& t); // C++17
Howard Hinnantd17880b2013-06-28 16:59:19 +0000176 basic_string& operator+=(const value_type* s);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000177 basic_string& operator+=(value_type c);
178 basic_string& operator+=(initializer_list<value_type>);
179
180 basic_string& append(const basic_string& str);
Marshall Clowe46031a2018-07-02 18:41:15 +0000181 template <class T>
182 basic_string& append(const T& t); // C++17
Marshall Clow8db7fb02014-03-04 19:17:19 +0000183 basic_string& append(const basic_string& str, size_type pos, size_type n=npos); //C++14
Marshall Clow82513342016-09-24 22:45:42 +0000184 template <class T>
185 basic_string& append(const T& t, size_type pos, size_type n=npos); // C++17
Howard Hinnantd17880b2013-06-28 16:59:19 +0000186 basic_string& append(const value_type* s, size_type n);
187 basic_string& append(const value_type* s);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000188 basic_string& append(size_type n, value_type c);
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000189 template<class InputIterator>
190 basic_string& append(InputIterator first, InputIterator last);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000191 basic_string& append(initializer_list<value_type>);
192
193 void push_back(value_type c);
194 void pop_back();
195 reference front();
196 const_reference front() const;
197 reference back();
198 const_reference back() const;
199
200 basic_string& assign(const basic_string& str);
Marshall Clowe46031a2018-07-02 18:41:15 +0000201 template <class T>
202 basic_string& assign(const T& t); // C++17
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000203 basic_string& assign(basic_string&& str);
Marshall Clow8db7fb02014-03-04 19:17:19 +0000204 basic_string& assign(const basic_string& str, size_type pos, size_type n=npos); // C++14
Marshall Clow82513342016-09-24 22:45:42 +0000205 template <class T>
206 basic_string& assign(const T& t, size_type pos, size_type n=npos); // C++17
Howard Hinnantd17880b2013-06-28 16:59:19 +0000207 basic_string& assign(const value_type* s, size_type n);
208 basic_string& assign(const value_type* s);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000209 basic_string& assign(size_type n, value_type c);
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000210 template<class InputIterator>
211 basic_string& assign(InputIterator first, InputIterator last);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000212 basic_string& assign(initializer_list<value_type>);
213
214 basic_string& insert(size_type pos1, const basic_string& str);
Marshall Clowe46031a2018-07-02 18:41:15 +0000215 template <class T>
216 basic_string& insert(size_type pos1, const T& t);
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000217 basic_string& insert(size_type pos1, const basic_string& str,
218 size_type pos2, size_type n);
Marshall Clow82513342016-09-24 22:45:42 +0000219 template <class T>
220 basic_string& insert(size_type pos1, const T& t, size_type pos2, size_type n); // C++17
Marshall Clow8db7fb02014-03-04 19:17:19 +0000221 basic_string& insert(size_type pos, const value_type* s, size_type n=npos); //C++14
Howard Hinnantd17880b2013-06-28 16:59:19 +0000222 basic_string& insert(size_type pos, const value_type* s);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000223 basic_string& insert(size_type pos, size_type n, value_type c);
224 iterator insert(const_iterator p, value_type c);
225 iterator insert(const_iterator p, size_type n, value_type c);
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000226 template<class InputIterator>
227 iterator insert(const_iterator p, InputIterator first, InputIterator last);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000228 iterator insert(const_iterator p, initializer_list<value_type>);
229
230 basic_string& erase(size_type pos = 0, size_type n = npos);
231 iterator erase(const_iterator position);
232 iterator erase(const_iterator first, const_iterator last);
233
234 basic_string& replace(size_type pos1, size_type n1, const basic_string& str);
Marshall Clowe46031a2018-07-02 18:41:15 +0000235 template <class T>
236 basic_string& replace(size_type pos1, size_type n1, const T& t); // C++17
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000237 basic_string& replace(size_type pos1, size_type n1, const basic_string& str,
Marshall Clow8db7fb02014-03-04 19:17:19 +0000238 size_type pos2, size_type n2=npos); // C++14
Marshall Clow82513342016-09-24 22:45:42 +0000239 template <class T>
240 basic_string& replace(size_type pos1, size_type n1, const T& t,
241 size_type pos2, size_type n); // C++17
Howard Hinnantd17880b2013-06-28 16:59:19 +0000242 basic_string& replace(size_type pos, size_type n1, const value_type* s, size_type n2);
243 basic_string& replace(size_type pos, size_type n1, const value_type* s);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000244 basic_string& replace(size_type pos, size_type n1, size_type n2, value_type c);
Howard Hinnant990d6e82010-11-17 21:11:40 +0000245 basic_string& replace(const_iterator i1, const_iterator i2, const basic_string& str);
Marshall Clowe46031a2018-07-02 18:41:15 +0000246 template <class T>
247 basic_string& replace(const_iterator i1, const_iterator i2, const T& t); // C++17
Howard Hinnantd17880b2013-06-28 16:59:19 +0000248 basic_string& replace(const_iterator i1, const_iterator i2, const value_type* s, size_type n);
249 basic_string& replace(const_iterator i1, const_iterator i2, const value_type* s);
Howard Hinnant990d6e82010-11-17 21:11:40 +0000250 basic_string& replace(const_iterator i1, const_iterator i2, size_type n, value_type c);
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000251 template<class InputIterator>
Howard Hinnant990d6e82010-11-17 21:11:40 +0000252 basic_string& replace(const_iterator i1, const_iterator i2, InputIterator j1, InputIterator j2);
253 basic_string& replace(const_iterator i1, const_iterator i2, initializer_list<value_type>);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000254
Howard Hinnantd17880b2013-06-28 16:59:19 +0000255 size_type copy(value_type* s, size_type n, size_type pos = 0) const;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000256 basic_string substr(size_type pos = 0, size_type n = npos) const;
257
Howard Hinnant3e276872011-06-03 18:40:47 +0000258 void swap(basic_string& str)
Marshall Clow8982dcd2015-07-13 20:04:56 +0000259 noexcept(allocator_traits<allocator_type>::propagate_on_container_swap::value ||
260 allocator_traits<allocator_type>::is_always_equal::value); // C++17
Howard Hinnantc51e1022010-05-11 19:42:16 +0000261
Howard Hinnantd17880b2013-06-28 16:59:19 +0000262 const value_type* c_str() const noexcept;
263 const value_type* data() const noexcept;
Marshall Clowd3c22392016-03-08 15:44:30 +0000264 value_type* data() noexcept; // C++17
Howard Hinnantc51e1022010-05-11 19:42:16 +0000265
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000266 allocator_type get_allocator() const noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000267
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000268 size_type find(const basic_string& str, size_type pos = 0) const noexcept;
Marshall Clowe46031a2018-07-02 18:41:15 +0000269 template <class T>
zoecarver1997e0a2021-02-05 11:54:47 -0800270 size_type find(const T& t, size_type pos = 0) const noexcept; // C++17, noexcept as an extension
Howard Hinnantd17880b2013-06-28 16:59:19 +0000271 size_type find(const value_type* s, size_type pos, size_type n) const noexcept;
272 size_type find(const value_type* s, size_type pos = 0) const noexcept;
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000273 size_type find(value_type c, size_type pos = 0) const noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000274
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000275 size_type rfind(const basic_string& str, size_type pos = npos) const noexcept;
Marshall Clowe46031a2018-07-02 18:41:15 +0000276 template <class T>
zoecarver1997e0a2021-02-05 11:54:47 -0800277 size_type rfind(const T& t, size_type pos = npos) const noexcept; // C++17, noexcept as an extension
Howard Hinnantd17880b2013-06-28 16:59:19 +0000278 size_type rfind(const value_type* s, size_type pos, size_type n) const noexcept;
279 size_type rfind(const value_type* s, size_type pos = npos) const noexcept;
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000280 size_type rfind(value_type c, size_type pos = npos) const noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000281
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000282 size_type find_first_of(const basic_string& str, size_type pos = 0) const noexcept;
Marshall Clowe46031a2018-07-02 18:41:15 +0000283 template <class T>
zoecarver1997e0a2021-02-05 11:54:47 -0800284 size_type find_first_of(const T& t, size_type pos = 0) const noexcept; // C++17, noexcept as an extension
Howard Hinnantd17880b2013-06-28 16:59:19 +0000285 size_type find_first_of(const value_type* s, size_type pos, size_type n) const noexcept;
286 size_type find_first_of(const value_type* s, size_type pos = 0) const noexcept;
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000287 size_type find_first_of(value_type c, size_type pos = 0) const noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000288
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000289 size_type find_last_of(const basic_string& str, size_type pos = npos) const noexcept;
Marshall Clowe46031a2018-07-02 18:41:15 +0000290 template <class T>
zoecarver1997e0a2021-02-05 11:54:47 -0800291 size_type find_last_of(const T& t, size_type pos = npos) const noexcept noexcept; // C++17, noexcept as an extension
Howard Hinnantd17880b2013-06-28 16:59:19 +0000292 size_type find_last_of(const value_type* s, size_type pos, size_type n) const noexcept;
293 size_type find_last_of(const value_type* s, size_type pos = npos) const noexcept;
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000294 size_type find_last_of(value_type c, size_type pos = npos) const noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000295
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000296 size_type find_first_not_of(const basic_string& str, size_type pos = 0) const noexcept;
Marshall Clowe46031a2018-07-02 18:41:15 +0000297 template <class T>
zoecarver1997e0a2021-02-05 11:54:47 -0800298 size_type find_first_not_of(const T& t, size_type pos = 0) const noexcept; // C++17, noexcept as an extension
Howard Hinnantd17880b2013-06-28 16:59:19 +0000299 size_type find_first_not_of(const value_type* s, size_type pos, size_type n) const noexcept;
300 size_type find_first_not_of(const value_type* s, size_type pos = 0) const noexcept;
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000301 size_type find_first_not_of(value_type c, size_type pos = 0) const noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000302
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000303 size_type find_last_not_of(const basic_string& str, size_type pos = npos) const noexcept;
Marshall Clowe46031a2018-07-02 18:41:15 +0000304 template <class T>
zoecarver1997e0a2021-02-05 11:54:47 -0800305 size_type find_last_not_of(const T& t, size_type pos = npos) const noexcept; // C++17, noexcept as an extension
Howard Hinnantd17880b2013-06-28 16:59:19 +0000306 size_type find_last_not_of(const value_type* s, size_type pos, size_type n) const noexcept;
307 size_type find_last_not_of(const value_type* s, size_type pos = npos) const noexcept;
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000308 size_type find_last_not_of(value_type c, size_type pos = npos) const noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000309
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000310 int compare(const basic_string& str) const noexcept;
Marshall Clowe46031a2018-07-02 18:41:15 +0000311 template <class T>
zoecarver1997e0a2021-02-05 11:54:47 -0800312 int compare(const T& t) const noexcept; // C++17, noexcept as an extension
Howard Hinnantc51e1022010-05-11 19:42:16 +0000313 int compare(size_type pos1, size_type n1, const basic_string& str) const;
Marshall Clowe46031a2018-07-02 18:41:15 +0000314 template <class T>
315 int compare(size_type pos1, size_type n1, const T& t) const; // C++17
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000316 int compare(size_type pos1, size_type n1, const basic_string& str,
Marshall Clow8db7fb02014-03-04 19:17:19 +0000317 size_type pos2, size_type n2=npos) const; // C++14
Marshall Clow82513342016-09-24 22:45:42 +0000318 template <class T>
319 int compare(size_type pos1, size_type n1, const T& t,
320 size_type pos2, size_type n2=npos) const; // C++17
Howard Hinnantd17880b2013-06-28 16:59:19 +0000321 int compare(const value_type* s) const noexcept;
322 int compare(size_type pos1, size_type n1, const value_type* s) const;
323 int compare(size_type pos1, size_type n1, const value_type* s, size_type n2) const;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000324
Marek Kurdej24b4c512021-01-07 12:29:04 +0100325 bool starts_with(basic_string_view<charT, traits> sv) const noexcept; // C++20
326 bool starts_with(charT c) const noexcept; // C++20
327 bool starts_with(const charT* s) const; // C++20
328 bool ends_with(basic_string_view<charT, traits> sv) const noexcept; // C++20
329 bool ends_with(charT c) const noexcept; // C++20
330 bool ends_with(const charT* s) const; // C++20
Marshall Clow18c293b2017-12-04 20:11:38 +0000331
Wim Leflere023c3542021-01-19 14:33:30 -0500332 constexpr bool contains(basic_string_view<charT, traits> sv) const noexcept; // C++2b
333 constexpr bool contains(charT c) const noexcept; // C++2b
334 constexpr bool contains(const charT* s) const; // C++2b
335
Howard Hinnantc51e1022010-05-11 19:42:16 +0000336 bool __invariants() const;
337};
338
Marshall Clowa0563332018-02-08 06:34:03 +0000339template<class InputIterator,
340 class Allocator = allocator<typename iterator_traits<InputIterator>::value_type>>
341basic_string(InputIterator, InputIterator, Allocator = Allocator())
342 -> basic_string<typename iterator_traits<InputIterator>::value_type,
343 char_traits<typename iterator_traits<InputIterator>::value_type>,
344 Allocator>; // C++17
345
Howard Hinnantc51e1022010-05-11 19:42:16 +0000346template<class charT, class traits, class Allocator>
347basic_string<charT, traits, Allocator>
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000348operator+(const basic_string<charT, traits, Allocator>& lhs,
349 const basic_string<charT, traits, Allocator>& rhs);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000350
351template<class charT, class traits, class Allocator>
352basic_string<charT, traits, Allocator>
353operator+(const charT* lhs , const basic_string<charT,traits,Allocator>&rhs);
354
355template<class charT, class traits, class Allocator>
356basic_string<charT, traits, Allocator>
357operator+(charT lhs, const basic_string<charT,traits,Allocator>& rhs);
358
359template<class charT, class traits, class Allocator>
360basic_string<charT, traits, Allocator>
361operator+(const basic_string<charT, traits, Allocator>& lhs, const charT* rhs);
362
363template<class charT, class traits, class Allocator>
364basic_string<charT, traits, Allocator>
365operator+(const basic_string<charT, traits, Allocator>& lhs, charT rhs);
366
367template<class charT, class traits, class Allocator>
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000368bool operator==(const basic_string<charT, traits, Allocator>& lhs,
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000369 const basic_string<charT, traits, Allocator>& rhs) noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000370
371template<class charT, class traits, class Allocator>
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000372bool operator==(const charT* lhs, const basic_string<charT, traits, Allocator>& rhs) noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000373
374template<class charT, class traits, class Allocator>
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000375bool operator==(const basic_string<charT,traits,Allocator>& lhs, const charT* rhs) noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000376
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000377template<class charT, class traits, class Allocator>
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000378bool operator!=(const basic_string<charT,traits,Allocator>& lhs,
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000379 const basic_string<charT, traits, Allocator>& rhs) noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000380
381template<class charT, class traits, class Allocator>
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000382bool operator!=(const charT* lhs, const basic_string<charT, traits, Allocator>& rhs) noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000383
384template<class charT, class traits, class Allocator>
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000385bool operator!=(const basic_string<charT, traits, Allocator>& lhs, const charT* rhs) noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000386
387template<class charT, class traits, class Allocator>
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000388bool operator< (const basic_string<charT, traits, Allocator>& lhs,
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000389 const basic_string<charT, traits, Allocator>& rhs) noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000390
391template<class charT, class traits, class Allocator>
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000392bool operator< (const basic_string<charT, traits, Allocator>& lhs, const charT* rhs) noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000393
394template<class charT, class traits, class Allocator>
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000395bool operator< (const charT* lhs, const basic_string<charT, traits, Allocator>& rhs) noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000396
397template<class charT, class traits, class Allocator>
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000398bool operator> (const basic_string<charT, traits, Allocator>& lhs,
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000399 const basic_string<charT, traits, Allocator>& rhs) noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000400
401template<class charT, class traits, class Allocator>
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000402bool operator> (const basic_string<charT, traits, Allocator>& lhs, const charT* rhs) noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000403
404template<class charT, class traits, class Allocator>
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000405bool operator> (const charT* lhs, const basic_string<charT, traits, Allocator>& rhs) noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000406
407template<class charT, class traits, class Allocator>
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000408bool operator<=(const basic_string<charT, traits, Allocator>& lhs,
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000409 const basic_string<charT, traits, Allocator>& rhs) noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000410
411template<class charT, class traits, class Allocator>
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000412bool operator<=(const basic_string<charT, traits, Allocator>& lhs, const charT* rhs) noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000413
414template<class charT, class traits, class Allocator>
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000415bool operator<=(const charT* lhs, const basic_string<charT, traits, Allocator>& rhs) noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000416
417template<class charT, class traits, class Allocator>
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000418bool operator>=(const basic_string<charT, traits, Allocator>& lhs,
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000419 const basic_string<charT, traits, Allocator>& rhs) noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000420
421template<class charT, class traits, class Allocator>
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000422bool operator>=(const basic_string<charT, traits, Allocator>& lhs, const charT* rhs) noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000423
424template<class charT, class traits, class Allocator>
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000425bool operator>=(const charT* lhs, const basic_string<charT, traits, Allocator>& rhs) noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000426
427template<class charT, class traits, class Allocator>
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000428void swap(basic_string<charT, traits, Allocator>& lhs,
Howard Hinnant3e276872011-06-03 18:40:47 +0000429 basic_string<charT, traits, Allocator>& rhs)
430 noexcept(noexcept(lhs.swap(rhs)));
Howard Hinnantc51e1022010-05-11 19:42:16 +0000431
432template<class charT, class traits, class Allocator>
433basic_istream<charT, traits>&
434operator>>(basic_istream<charT, traits>& is, basic_string<charT, traits, Allocator>& str);
435
436template<class charT, class traits, class Allocator>
437basic_ostream<charT, traits>&
438operator<<(basic_ostream<charT, traits>& os, const basic_string<charT, traits, Allocator>& str);
439
440template<class charT, class traits, class Allocator>
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000441basic_istream<charT, traits>&
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000442getline(basic_istream<charT, traits>& is, basic_string<charT, traits, Allocator>& str,
443 charT delim);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000444
445template<class charT, class traits, class Allocator>
446basic_istream<charT, traits>&
447getline(basic_istream<charT, traits>& is, basic_string<charT, traits, Allocator>& str);
448
Marshall Clow29b53f22018-12-14 18:49:35 +0000449template<class charT, class traits, class Allocator, class U>
Marek Kurdeja98b1412020-05-02 13:58:03 +0200450typename basic_string<charT, traits, Allocator>::size_type
451erase(basic_string<charT, traits, Allocator>& c, const U& value); // C++20
Marshall Clow29b53f22018-12-14 18:49:35 +0000452template<class charT, class traits, class Allocator, class Predicate>
Marek Kurdeja98b1412020-05-02 13:58:03 +0200453typename basic_string<charT, traits, Allocator>::size_type
454erase_if(basic_string<charT, traits, Allocator>& c, Predicate pred); // C++20
Marshall Clow29b53f22018-12-14 18:49:35 +0000455
Howard Hinnantc51e1022010-05-11 19:42:16 +0000456typedef basic_string<char> string;
457typedef basic_string<wchar_t> wstring;
Marek Kurdeje3ac4e22021-03-23 17:15:07 +0100458typedef basic_string<char8_t> u8string; // C++20
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000459typedef basic_string<char16_t> u16string;
460typedef basic_string<char32_t> u32string;
461
Bruce Mitchener170d8972020-11-24 12:53:53 -0500462int stoi (const string& str, size_t* idx = nullptr, int base = 10);
463long stol (const string& str, size_t* idx = nullptr, int base = 10);
464unsigned long stoul (const string& str, size_t* idx = nullptr, int base = 10);
465long long stoll (const string& str, size_t* idx = nullptr, int base = 10);
466unsigned long long stoull(const string& str, size_t* idx = nullptr, int base = 10);
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000467
Bruce Mitchener170d8972020-11-24 12:53:53 -0500468float stof (const string& str, size_t* idx = nullptr);
469double stod (const string& str, size_t* idx = nullptr);
470long double stold(const string& str, size_t* idx = nullptr);
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000471
472string to_string(int val);
473string to_string(unsigned val);
474string to_string(long val);
475string to_string(unsigned long val);
476string to_string(long long val);
477string to_string(unsigned long long val);
478string to_string(float val);
479string to_string(double val);
480string to_string(long double val);
481
Bruce Mitchener170d8972020-11-24 12:53:53 -0500482int stoi (const wstring& str, size_t* idx = nullptr, int base = 10);
483long stol (const wstring& str, size_t* idx = nullptr, int base = 10);
484unsigned long stoul (const wstring& str, size_t* idx = nullptr, int base = 10);
485long long stoll (const wstring& str, size_t* idx = nullptr, int base = 10);
486unsigned long long stoull(const wstring& str, size_t* idx = nullptr, int base = 10);
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000487
Bruce Mitchener170d8972020-11-24 12:53:53 -0500488float stof (const wstring& str, size_t* idx = nullptr);
489double stod (const wstring& str, size_t* idx = nullptr);
490long double stold(const wstring& str, size_t* idx = nullptr);
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000491
492wstring to_wstring(int val);
493wstring to_wstring(unsigned val);
494wstring to_wstring(long val);
495wstring to_wstring(unsigned long val);
496wstring to_wstring(long long val);
497wstring to_wstring(unsigned long long val);
498wstring to_wstring(float val);
499wstring to_wstring(double val);
500wstring to_wstring(long double val);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000501
502template <> struct hash<string>;
Marek Kurdeje3ac4e22021-03-23 17:15:07 +0100503template <> struct hash<u8string>; // C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000504template <> struct hash<u16string>;
505template <> struct hash<u32string>;
506template <> struct hash<wstring>;
507
Marshall Clowcba751f2013-07-23 17:05:24 +0000508basic_string<char> operator "" s( const char *str, size_t len ); // C++14
509basic_string<wchar_t> operator "" s( const wchar_t *str, size_t len ); // C++14
Marek Kurdeje3ac4e22021-03-23 17:15:07 +0100510basic_string<char8_t> operator "" s( const char8_t *str, size_t len ); // C++20
Marshall Clowcba751f2013-07-23 17:05:24 +0000511basic_string<char16_t> operator "" s( const char16_t *str, size_t len ); // C++14
512basic_string<char32_t> operator "" s( const char32_t *str, size_t len ); // C++14
513
Howard Hinnantc51e1022010-05-11 19:42:16 +0000514} // std
515
516*/
517
518#include <__config>
Arthur O'Dwyeref181602021-05-19 11:57:04 -0400519#include <__debug>
520#include <__functional_base>
Louis Dionne77249522021-06-11 09:55:11 -0400521#include <__iterator/wrap_iter.h>
Howard Hinnantc51e1022010-05-11 19:42:16 +0000522#include <algorithm>
Arthur O'Dwyeref181602021-05-19 11:57:04 -0400523#include <compare>
524#include <cstdio> // EOF
525#include <cstring>
526#include <cwchar>
527#include <initializer_list>
528#include <iosfwd>
Howard Hinnantc51e1022010-05-11 19:42:16 +0000529#include <iterator>
Howard Hinnantc51e1022010-05-11 19:42:16 +0000530#include <memory>
531#include <stdexcept>
Arthur O'Dwyeref181602021-05-19 11:57:04 -0400532#include <string_view>
Howard Hinnantc51e1022010-05-11 19:42:16 +0000533#include <type_traits>
Arthur O'Dwyeref181602021-05-19 11:57:04 -0400534#include <utility>
Marshall Clow0a1e7502018-09-12 19:41:40 +0000535#include <version>
Marshall Clowdf63a6d2016-07-21 05:31:24 +0000536
Arthur O'Dwyeref181602021-05-19 11:57:04 -0400537#ifndef _LIBCPP_HAS_NO_UNICODE_CHARS
538# include <cstdint>
539#endif
Eric Fiselier14b6de92014-08-10 23:53:08 +0000540
Howard Hinnantaaaa52b2011-10-17 20:05:10 +0000541#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
Howard Hinnantc51e1022010-05-11 19:42:16 +0000542#pragma GCC system_header
Howard Hinnantaaaa52b2011-10-17 20:05:10 +0000543#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +0000544
Eric Fiselierf4433a32017-05-31 22:07:49 +0000545_LIBCPP_PUSH_MACROS
546#include <__undef_macros>
547
548
Howard Hinnantc51e1022010-05-11 19:42:16 +0000549_LIBCPP_BEGIN_NAMESPACE_STD
550
551// fpos
552
553template <class _StateT>
Eric Fiselierb5eb1bf2017-01-04 23:56:00 +0000554class _LIBCPP_TEMPLATE_VIS fpos
Howard Hinnantc51e1022010-05-11 19:42:16 +0000555{
556private:
557 _StateT __st_;
558 streamoff __off_;
559public:
560 _LIBCPP_INLINE_VISIBILITY fpos(streamoff __off = streamoff()) : __st_(), __off_(__off) {}
561
562 _LIBCPP_INLINE_VISIBILITY operator streamoff() const {return __off_;}
563
564 _LIBCPP_INLINE_VISIBILITY _StateT state() const {return __st_;}
565 _LIBCPP_INLINE_VISIBILITY void state(_StateT __st) {__st_ = __st;}
566
567 _LIBCPP_INLINE_VISIBILITY fpos& operator+=(streamoff __off) {__off_ += __off; return *this;}
568 _LIBCPP_INLINE_VISIBILITY fpos operator+ (streamoff __off) const {fpos __t(*this); __t += __off; return __t;}
569 _LIBCPP_INLINE_VISIBILITY fpos& operator-=(streamoff __off) {__off_ -= __off; return *this;}
570 _LIBCPP_INLINE_VISIBILITY fpos operator- (streamoff __off) const {fpos __t(*this); __t -= __off; return __t;}
571};
572
573template <class _StateT>
574inline _LIBCPP_INLINE_VISIBILITY
575streamoff operator-(const fpos<_StateT>& __x, const fpos<_StateT>& __y)
576 {return streamoff(__x) - streamoff(__y);}
577
578template <class _StateT>
579inline _LIBCPP_INLINE_VISIBILITY
580bool operator==(const fpos<_StateT>& __x, const fpos<_StateT>& __y)
581 {return streamoff(__x) == streamoff(__y);}
582
583template <class _StateT>
584inline _LIBCPP_INLINE_VISIBILITY
585bool operator!=(const fpos<_StateT>& __x, const fpos<_StateT>& __y)
586 {return streamoff(__x) != streamoff(__y);}
587
Howard Hinnantc51e1022010-05-11 19:42:16 +0000588// basic_string
589
590template<class _CharT, class _Traits, class _Allocator>
591basic_string<_CharT, _Traits, _Allocator>
Howard Hinnant944510a2011-06-14 19:58:17 +0000592operator+(const basic_string<_CharT, _Traits, _Allocator>& __x,
593 const basic_string<_CharT, _Traits, _Allocator>& __y);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000594
595template<class _CharT, class _Traits, class _Allocator>
596basic_string<_CharT, _Traits, _Allocator>
Howard Hinnant944510a2011-06-14 19:58:17 +0000597operator+(const _CharT* __x, const basic_string<_CharT,_Traits,_Allocator>& __y);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000598
599template<class _CharT, class _Traits, class _Allocator>
600basic_string<_CharT, _Traits, _Allocator>
Howard Hinnant944510a2011-06-14 19:58:17 +0000601operator+(_CharT __x, const basic_string<_CharT,_Traits,_Allocator>& __y);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000602
603template<class _CharT, class _Traits, class _Allocator>
Louis Dionne8f8d95d2018-11-21 17:31:55 +0000604inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +0000605basic_string<_CharT, _Traits, _Allocator>
Howard Hinnant944510a2011-06-14 19:58:17 +0000606operator+(const basic_string<_CharT, _Traits, _Allocator>& __x, const _CharT* __y);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000607
608template<class _CharT, class _Traits, class _Allocator>
609basic_string<_CharT, _Traits, _Allocator>
Howard Hinnant944510a2011-06-14 19:58:17 +0000610operator+(const basic_string<_CharT, _Traits, _Allocator>& __x, _CharT __y);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000611
Shoaib Meenaiea363712017-07-29 02:54:41 +0000612_LIBCPP_EXTERN_TEMPLATE(_LIBCPP_FUNC_VIS string operator+<char, char_traits<char>, allocator<char> >(char const*, string const&))
613
Howard Hinnantc51e1022010-05-11 19:42:16 +0000614template <bool>
Eric Fiselierb5eb1bf2017-01-04 23:56:00 +0000615class _LIBCPP_TEMPLATE_VIS __basic_string_common
Howard Hinnantc51e1022010-05-11 19:42:16 +0000616{
617protected:
Marshall Clow8fea1612016-08-25 15:09:01 +0000618 _LIBCPP_NORETURN void __throw_length_error() const;
619 _LIBCPP_NORETURN void __throw_out_of_range() const;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000620};
621
622template <bool __b>
623void
624__basic_string_common<__b>::__throw_length_error() const
625{
Marshall Clow8fea1612016-08-25 15:09:01 +0000626 _VSTD::__throw_length_error("basic_string");
Howard Hinnantc51e1022010-05-11 19:42:16 +0000627}
628
629template <bool __b>
630void
631__basic_string_common<__b>::__throw_out_of_range() const
632{
Marshall Clow8fea1612016-08-25 15:09:01 +0000633 _VSTD::__throw_out_of_range("basic_string");
Howard Hinnantc51e1022010-05-11 19:42:16 +0000634}
635
Eric Fiselier1b57fa82016-09-15 22:27:07 +0000636_LIBCPP_EXTERN_TEMPLATE(class _LIBCPP_EXTERN_TEMPLATE_TYPE_VIS __basic_string_common<true>)
Howard Hinnantc51e1022010-05-11 19:42:16 +0000637
Marshall Clow039b2f02016-01-13 21:54:34 +0000638template <class _Iter>
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -0400639struct __string_is_trivial_iterator : public false_type {};
640
641template <class _Tp>
642struct __string_is_trivial_iterator<_Tp*>
643 : public is_arithmetic<_Tp> {};
Marshall Clow039b2f02016-01-13 21:54:34 +0000644
Louis Dionne173f29e2019-05-29 16:01:36 +0000645template <class _Iter>
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -0400646struct __string_is_trivial_iterator<__wrap_iter<_Iter> >
647 : public __string_is_trivial_iterator<_Iter> {};
Marshall Clow039b2f02016-01-13 21:54:34 +0000648
Marshall Clow82513342016-09-24 22:45:42 +0000649template <class _CharT, class _Traits, class _Tp>
Eric Fiselierc522ceb2020-01-15 16:57:08 -0500650struct __can_be_converted_to_string_view : public _BoolConstant<
651 is_convertible<const _Tp&, basic_string_view<_CharT, _Traits> >::value &&
652 !is_convertible<const _Tp&, const _CharT*>::value
653 > {};
Marshall Clow82513342016-09-24 22:45:42 +0000654
Evgeniy Stepanovda2ff7e2015-10-13 23:48:28 +0000655#ifdef _LIBCPP_ABI_ALTERNATE_STRING_LAYOUT
Howard Hinnant68bf1812013-04-30 21:44:48 +0000656
657template <class _CharT, size_t = sizeof(_CharT)>
658struct __padding
659{
660 unsigned char __xx[sizeof(_CharT)-1];
661};
662
663template <class _CharT>
664struct __padding<_CharT, 1>
665{
666};
667
Louis Dionne2b1ceaa2021-04-20 12:03:32 -0400668#endif // _LIBCPP_ABI_ALTERNATE_STRING_LAYOUT
Howard Hinnant68bf1812013-04-30 21:44:48 +0000669
Arthur O'Dwyerafa5d5f2021-04-18 21:47:08 -0400670#ifndef _LIBCPP_HAS_NO_CHAR8_T
Richard Smith256954d2020-11-11 17:12:18 -0800671typedef basic_string<char8_t> u8string;
672#endif
673
674#ifndef _LIBCPP_HAS_NO_UNICODE_CHARS
675typedef basic_string<char16_t> u16string;
676typedef basic_string<char32_t> u32string;
Louis Dionne2b1ceaa2021-04-20 12:03:32 -0400677#endif // _LIBCPP_HAS_NO_UNICODE_CHARS
Richard Smith256954d2020-11-11 17:12:18 -0800678
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000679template<class _CharT, class _Traits, class _Allocator>
Richard Smith256954d2020-11-11 17:12:18 -0800680class
681 _LIBCPP_TEMPLATE_VIS
Arthur O'Dwyerafa5d5f2021-04-18 21:47:08 -0400682#ifndef _LIBCPP_HAS_NO_CHAR8_T
Richard Smith256954d2020-11-11 17:12:18 -0800683 _LIBCPP_PREFERRED_NAME(u8string)
684#endif
685#ifndef _LIBCPP_HAS_NO_UNICODE_CHARS
686 _LIBCPP_PREFERRED_NAME(u16string)
687 _LIBCPP_PREFERRED_NAME(u32string)
688#endif
689 basic_string
Howard Hinnantc51e1022010-05-11 19:42:16 +0000690 : private __basic_string_common<true>
691{
692public:
693 typedef basic_string __self;
Marshall Clowdf63a6d2016-07-21 05:31:24 +0000694 typedef basic_string_view<_CharT, _Traits> __self_view;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000695 typedef _Traits traits_type;
Marshall Clowa3a74e02017-03-15 18:41:11 +0000696 typedef _CharT value_type;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000697 typedef _Allocator allocator_type;
Howard Hinnantea8f7e12010-11-17 17:55:08 +0000698 typedef allocator_traits<allocator_type> __alloc_traits;
699 typedef typename __alloc_traits::size_type size_type;
700 typedef typename __alloc_traits::difference_type difference_type;
Howard Hinnant3e276872011-06-03 18:40:47 +0000701 typedef value_type& reference;
702 typedef const value_type& const_reference;
Howard Hinnantea8f7e12010-11-17 17:55:08 +0000703 typedef typename __alloc_traits::pointer pointer;
704 typedef typename __alloc_traits::const_pointer const_pointer;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000705
Marshall Clow79f33542018-03-21 00:36:05 +0000706 static_assert((!is_array<value_type>::value), "Character type of basic_string must not be an array");
707 static_assert(( is_standard_layout<value_type>::value), "Character type of basic_string must be standard-layout");
708 static_assert(( is_trivial<value_type>::value), "Character type of basic_string must be trivial");
709 static_assert(( is_same<_CharT, typename traits_type::char_type>::value),
Howard Hinnant8ea98242013-08-23 17:37:05 +0000710 "traits_type::char_type must be the same type as CharT");
Marshall Clow79f33542018-03-21 00:36:05 +0000711 static_assert(( is_same<typename allocator_type::value_type, value_type>::value),
Howard Hinnant8ea98242013-08-23 17:37:05 +0000712 "Allocator::value_type must be same type as value_type");
Marshall Clowe46031a2018-07-02 18:41:15 +0000713
Howard Hinnantc51e1022010-05-11 19:42:16 +0000714 typedef __wrap_iter<pointer> iterator;
715 typedef __wrap_iter<const_pointer> const_iterator;
Howard Hinnantb1ad5a82011-06-30 21:18:19 +0000716 typedef _VSTD::reverse_iterator<iterator> reverse_iterator;
717 typedef _VSTD::reverse_iterator<const_iterator> const_reverse_iterator;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000718
719private:
Howard Hinnant68bf1812013-04-30 21:44:48 +0000720
Evgeniy Stepanovda2ff7e2015-10-13 23:48:28 +0000721#ifdef _LIBCPP_ABI_ALTERNATE_STRING_LAYOUT
Howard Hinnant68bf1812013-04-30 21:44:48 +0000722
723 struct __long
724 {
725 pointer __data_;
726 size_type __size_;
727 size_type __cap_;
728 };
729
Eric Fiseliere9cc5922017-10-17 13:16:01 +0000730#ifdef _LIBCPP_BIG_ENDIAN
Ben Craig4b6f5f12017-07-12 01:45:13 +0000731 static const size_type __short_mask = 0x01;
732 static const size_type __long_mask = 0x1ul;
Howard Hinnant68bf1812013-04-30 21:44:48 +0000733#else // _LIBCPP_BIG_ENDIAN
Ben Craig4b6f5f12017-07-12 01:45:13 +0000734 static const size_type __short_mask = 0x80;
735 static const size_type __long_mask = ~(size_type(~0) >> 1);
Louis Dionne2b1ceaa2021-04-20 12:03:32 -0400736#endif // _LIBCPP_BIG_ENDIAN
Howard Hinnant68bf1812013-04-30 21:44:48 +0000737
738 enum {__min_cap = (sizeof(__long) - 1)/sizeof(value_type) > 2 ?
739 (sizeof(__long) - 1)/sizeof(value_type) : 2};
740
741 struct __short
742 {
743 value_type __data_[__min_cap];
744 struct
745 : __padding<value_type>
746 {
747 unsigned char __size_;
748 };
749 };
750
751#else
752
Howard Hinnantc51e1022010-05-11 19:42:16 +0000753 struct __long
754 {
755 size_type __cap_;
756 size_type __size_;
757 pointer __data_;
758 };
759
Eric Fiseliere9cc5922017-10-17 13:16:01 +0000760#ifdef _LIBCPP_BIG_ENDIAN
Ben Craig4b6f5f12017-07-12 01:45:13 +0000761 static const size_type __short_mask = 0x80;
762 static const size_type __long_mask = ~(size_type(~0) >> 1);
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000763#else // _LIBCPP_BIG_ENDIAN
Ben Craig4b6f5f12017-07-12 01:45:13 +0000764 static const size_type __short_mask = 0x01;
765 static const size_type __long_mask = 0x1ul;
Louis Dionne2b1ceaa2021-04-20 12:03:32 -0400766#endif // _LIBCPP_BIG_ENDIAN
Howard Hinnantc51e1022010-05-11 19:42:16 +0000767
Howard Hinnantc51e1022010-05-11 19:42:16 +0000768 enum {__min_cap = (sizeof(__long) - 1)/sizeof(value_type) > 2 ?
769 (sizeof(__long) - 1)/sizeof(value_type) : 2};
770
771 struct __short
772 {
773 union
774 {
775 unsigned char __size_;
Howard Hinnant49e145e2012-10-30 19:06:59 +0000776 value_type __lx;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000777 };
778 value_type __data_[__min_cap];
779 };
780
Louis Dionne2b1ceaa2021-04-20 12:03:32 -0400781#endif // _LIBCPP_ABI_ALTERNATE_STRING_LAYOUT
Howard Hinnant68bf1812013-04-30 21:44:48 +0000782
Howard Hinnant8ea98242013-08-23 17:37:05 +0000783 union __ulx{__long __lx; __short __lxx;};
Howard Hinnantc51e1022010-05-11 19:42:16 +0000784
Howard Hinnant8ea98242013-08-23 17:37:05 +0000785 enum {__n_words = sizeof(__ulx) / sizeof(size_type)};
Howard Hinnantc51e1022010-05-11 19:42:16 +0000786
787 struct __raw
788 {
789 size_type __words[__n_words];
790 };
791
792 struct __rep
793 {
794 union
795 {
796 __long __l;
797 __short __s;
798 __raw __r;
799 };
800 };
801
802 __compressed_pair<__rep, allocator_type> __r_;
803
Howard Hinnantc51e1022010-05-11 19:42:16 +0000804public:
Martin Storsjö88890c22021-02-22 01:13:13 +0200805 _LIBCPP_TEMPLATE_DATA_VIS
Howard Hinnantc51e1022010-05-11 19:42:16 +0000806 static const size_type npos = -1;
807
Howard Hinnant3e276872011-06-03 18:40:47 +0000808 _LIBCPP_INLINE_VISIBILITY basic_string()
809 _NOEXCEPT_(is_nothrow_default_constructible<allocator_type>::value);
Marshall Clowa80abc72015-06-03 19:56:43 +0000810
811 _LIBCPP_INLINE_VISIBILITY explicit basic_string(const allocator_type& __a)
812#if _LIBCPP_STD_VER <= 14
813 _NOEXCEPT_(is_nothrow_copy_constructible<allocator_type>::value);
814#else
815 _NOEXCEPT;
816#endif
817
Howard Hinnantc51e1022010-05-11 19:42:16 +0000818 basic_string(const basic_string& __str);
819 basic_string(const basic_string& __str, const allocator_type& __a);
Marshall Clowa80abc72015-06-03 19:56:43 +0000820
Eric Fiselierfc92be82017-04-19 00:28:44 +0000821#ifndef _LIBCPP_CXX03_LANG
Howard Hinnantebb0edf2011-01-26 00:06:59 +0000822 _LIBCPP_INLINE_VISIBILITY
Howard Hinnant3e276872011-06-03 18:40:47 +0000823 basic_string(basic_string&& __str)
Marshall Clowa80abc72015-06-03 19:56:43 +0000824#if _LIBCPP_STD_VER <= 14
Howard Hinnant3e276872011-06-03 18:40:47 +0000825 _NOEXCEPT_(is_nothrow_move_constructible<allocator_type>::value);
Marshall Clowa80abc72015-06-03 19:56:43 +0000826#else
827 _NOEXCEPT;
828#endif
829
Howard Hinnantebb0edf2011-01-26 00:06:59 +0000830 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +0000831 basic_string(basic_string&& __str, const allocator_type& __a);
Louis Dionne2b1ceaa2021-04-20 12:03:32 -0400832#endif // _LIBCPP_CXX03_LANG
Marshall Clowe46031a2018-07-02 18:41:15 +0000833
Eric Fiselierfe7fe0a2020-01-15 17:29:55 -0500834 template <class = _EnableIf<__is_allocator<_Allocator>::value, nullptr_t> >
Eric Fiseliera8567862018-07-17 05:48:48 +0000835 _LIBCPP_INLINE_VISIBILITY
Eric Fiselier5169d1c2019-12-16 19:03:23 -0500836 basic_string(const _CharT* __s) : __r_(__default_init_tag(), __default_init_tag()) {
Eric Fiseliera8567862018-07-17 05:48:48 +0000837 _LIBCPP_ASSERT(__s != nullptr, "basic_string(const char*) detected nullptr");
838 __init(__s, traits_type::length(__s));
Louis Dionneba400782020-10-02 15:02:52 -0400839# if _LIBCPP_DEBUG_LEVEL == 2
Eric Fiseliera8567862018-07-17 05:48:48 +0000840 __get_db()->__insert_c(this);
841# endif
842 }
Marshall Clowe46031a2018-07-02 18:41:15 +0000843
Eric Fiselierfe7fe0a2020-01-15 17:29:55 -0500844 template <class = _EnableIf<__is_allocator<_Allocator>::value, nullptr_t> >
Marshall Clowe46031a2018-07-02 18:41:15 +0000845 _LIBCPP_INLINE_VISIBILITY
846 basic_string(const _CharT* __s, const _Allocator& __a);
847
Marek Kurdej90d79712021-07-27 16:16:21 +0200848#if _LIBCPP_STD_VER > 20
849 basic_string(nullptr_t) = delete;
850#endif
851
Howard Hinnantcf823322010-12-17 14:46:43 +0000852 _LIBCPP_INLINE_VISIBILITY
Eric Fiselier812882b2017-02-17 01:17:10 +0000853 basic_string(const _CharT* __s, size_type __n);
Howard Hinnantcf823322010-12-17 14:46:43 +0000854 _LIBCPP_INLINE_VISIBILITY
Eric Fiselier812882b2017-02-17 01:17:10 +0000855 basic_string(const _CharT* __s, size_type __n, const _Allocator& __a);
Howard Hinnantcf823322010-12-17 14:46:43 +0000856 _LIBCPP_INLINE_VISIBILITY
Eric Fiselier812882b2017-02-17 01:17:10 +0000857 basic_string(size_type __n, _CharT __c);
Marshall Clowe46031a2018-07-02 18:41:15 +0000858
Eric Fiselierfe7fe0a2020-01-15 17:29:55 -0500859 template <class = _EnableIf<__is_allocator<_Allocator>::value, nullptr_t> >
Marshall Clowe46031a2018-07-02 18:41:15 +0000860 _LIBCPP_INLINE_VISIBILITY
861 basic_string(size_type __n, _CharT __c, const _Allocator& __a);
862
Marshall Clow83445802016-04-07 18:13:41 +0000863 basic_string(const basic_string& __str, size_type __pos, size_type __n,
Eric Fiselier812882b2017-02-17 01:17:10 +0000864 const _Allocator& __a = _Allocator());
Marshall Clow83445802016-04-07 18:13:41 +0000865 _LIBCPP_INLINE_VISIBILITY
866 basic_string(const basic_string& __str, size_type __pos,
Eric Fiselier812882b2017-02-17 01:17:10 +0000867 const _Allocator& __a = _Allocator());
Marshall Clowe46031a2018-07-02 18:41:15 +0000868
Eric Fiselierc522ceb2020-01-15 16:57:08 -0500869 template<class _Tp, class = _EnableIf<__can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value && !__is_same_uncvref<_Tp, basic_string>::value> >
Shoaib Meenai69c57412017-03-02 03:02:50 +0000870 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
Eric Fiselier812882b2017-02-17 01:17:10 +0000871 basic_string(const _Tp& __t, size_type __pos, size_type __n,
Eric Fiselierc522ceb2020-01-15 16:57:08 -0500872 const allocator_type& __a = allocator_type());
Marshall Clowe46031a2018-07-02 18:41:15 +0000873
Eric Fiselierc522ceb2020-01-15 16:57:08 -0500874 template<class _Tp, class = _EnableIf<__can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value &&
875 !__is_same_uncvref<_Tp, basic_string>::value> >
Marshall Clowe46031a2018-07-02 18:41:15 +0000876 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
877 explicit basic_string(const _Tp& __t);
878
Eric Fiselierc522ceb2020-01-15 16:57:08 -0500879 template<class _Tp, class = _EnableIf<__can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value && !__is_same_uncvref<_Tp, basic_string>::value> >
Marshall Clowe46031a2018-07-02 18:41:15 +0000880 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
881 explicit basic_string(const _Tp& __t, const allocator_type& __a);
882
Eric Fiselierfe7fe0a2020-01-15 17:29:55 -0500883 template<class _InputIterator, class = _EnableIf<__is_cpp17_input_iterator<_InputIterator>::value> >
Howard Hinnantcf823322010-12-17 14:46:43 +0000884 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +0000885 basic_string(_InputIterator __first, _InputIterator __last);
Eric Fiselierfe7fe0a2020-01-15 17:29:55 -0500886 template<class _InputIterator, class = _EnableIf<__is_cpp17_input_iterator<_InputIterator>::value> >
Howard Hinnantcf823322010-12-17 14:46:43 +0000887 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +0000888 basic_string(_InputIterator __first, _InputIterator __last, const allocator_type& __a);
Eric Fiselierfc92be82017-04-19 00:28:44 +0000889#ifndef _LIBCPP_CXX03_LANG
Howard Hinnantcf823322010-12-17 14:46:43 +0000890 _LIBCPP_INLINE_VISIBILITY
Eric Fiselier812882b2017-02-17 01:17:10 +0000891 basic_string(initializer_list<_CharT> __il);
Howard Hinnantcf823322010-12-17 14:46:43 +0000892 _LIBCPP_INLINE_VISIBILITY
Eric Fiselier812882b2017-02-17 01:17:10 +0000893 basic_string(initializer_list<_CharT> __il, const _Allocator& __a);
Louis Dionne2b1ceaa2021-04-20 12:03:32 -0400894#endif // _LIBCPP_CXX03_LANG
Howard Hinnantc51e1022010-05-11 19:42:16 +0000895
Eric Fiselierd9a702a2016-10-31 03:42:50 +0000896 inline ~basic_string();
Howard Hinnantc51e1022010-05-11 19:42:16 +0000897
Marshall Clowdf63a6d2016-07-21 05:31:24 +0000898 _LIBCPP_INLINE_VISIBILITY
899 operator __self_view() const _NOEXCEPT { return __self_view(data(), size()); }
900
Howard Hinnantea8f7e12010-11-17 17:55:08 +0000901 basic_string& operator=(const basic_string& __str);
Eric Fiselier5ec13b12017-01-23 21:24:58 +0000902
Eric Fiselierc522ceb2020-01-15 16:57:08 -0500903 template <class _Tp, class = _EnableIf<__can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value && !__is_same_uncvref<_Tp, basic_string>::value> >
Marshall Clowe46031a2018-07-02 18:41:15 +0000904 basic_string& operator=(const _Tp& __t)
905 {__self_view __sv = __t; return assign(__sv);}
906
Eric Fiselierfc92be82017-04-19 00:28:44 +0000907#ifndef _LIBCPP_CXX03_LANG
Howard Hinnantcf823322010-12-17 14:46:43 +0000908 _LIBCPP_INLINE_VISIBILITY
Howard Hinnant3e276872011-06-03 18:40:47 +0000909 basic_string& operator=(basic_string&& __str)
Marshall Clow2fe8a8d2015-08-18 18:57:00 +0000910 _NOEXCEPT_((__noexcept_move_assign_container<_Allocator, __alloc_traits>::value));
Eric Fiselierfc92be82017-04-19 00:28:44 +0000911 _LIBCPP_INLINE_VISIBILITY
912 basic_string& operator=(initializer_list<value_type> __il) {return assign(__il.begin(), __il.size());}
Howard Hinnantc51e1022010-05-11 19:42:16 +0000913#endif
Howard Hinnantd17880b2013-06-28 16:59:19 +0000914 _LIBCPP_INLINE_VISIBILITY basic_string& operator=(const value_type* __s) {return assign(__s);}
Marek Kurdej90d79712021-07-27 16:16:21 +0200915#if _LIBCPP_STD_VER > 20
916 basic_string& operator=(nullptr_t) = delete;
917#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +0000918 basic_string& operator=(value_type __c);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000919
Louis Dionneba400782020-10-02 15:02:52 -0400920#if _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnant8ea98242013-08-23 17:37:05 +0000921 _LIBCPP_INLINE_VISIBILITY
922 iterator begin() _NOEXCEPT
923 {return iterator(this, __get_pointer());}
924 _LIBCPP_INLINE_VISIBILITY
925 const_iterator begin() const _NOEXCEPT
926 {return const_iterator(this, __get_pointer());}
927 _LIBCPP_INLINE_VISIBILITY
928 iterator end() _NOEXCEPT
929 {return iterator(this, __get_pointer() + size());}
930 _LIBCPP_INLINE_VISIBILITY
931 const_iterator end() const _NOEXCEPT
932 {return const_iterator(this, __get_pointer() + size());}
933#else
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000934 _LIBCPP_INLINE_VISIBILITY
935 iterator begin() _NOEXCEPT
936 {return iterator(__get_pointer());}
937 _LIBCPP_INLINE_VISIBILITY
938 const_iterator begin() const _NOEXCEPT
Howard Hinnantd17880b2013-06-28 16:59:19 +0000939 {return const_iterator(__get_pointer());}
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000940 _LIBCPP_INLINE_VISIBILITY
941 iterator end() _NOEXCEPT
942 {return iterator(__get_pointer() + size());}
943 _LIBCPP_INLINE_VISIBILITY
944 const_iterator end() const _NOEXCEPT
Howard Hinnantd17880b2013-06-28 16:59:19 +0000945 {return const_iterator(__get_pointer() + size());}
Louis Dionne2b1ceaa2021-04-20 12:03:32 -0400946#endif // _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000947 _LIBCPP_INLINE_VISIBILITY
948 reverse_iterator rbegin() _NOEXCEPT
949 {return reverse_iterator(end());}
950 _LIBCPP_INLINE_VISIBILITY
951 const_reverse_iterator rbegin() const _NOEXCEPT
952 {return const_reverse_iterator(end());}
953 _LIBCPP_INLINE_VISIBILITY
954 reverse_iterator rend() _NOEXCEPT
955 {return reverse_iterator(begin());}
956 _LIBCPP_INLINE_VISIBILITY
957 const_reverse_iterator rend() const _NOEXCEPT
958 {return const_reverse_iterator(begin());}
Howard Hinnantc51e1022010-05-11 19:42:16 +0000959
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000960 _LIBCPP_INLINE_VISIBILITY
961 const_iterator cbegin() const _NOEXCEPT
962 {return begin();}
963 _LIBCPP_INLINE_VISIBILITY
964 const_iterator cend() const _NOEXCEPT
965 {return end();}
966 _LIBCPP_INLINE_VISIBILITY
967 const_reverse_iterator crbegin() const _NOEXCEPT
968 {return rbegin();}
969 _LIBCPP_INLINE_VISIBILITY
970 const_reverse_iterator crend() const _NOEXCEPT
971 {return rend();}
Howard Hinnantc51e1022010-05-11 19:42:16 +0000972
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000973 _LIBCPP_INLINE_VISIBILITY size_type size() const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +0000974 {return __is_long() ? __get_long_size() : __get_short_size();}
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000975 _LIBCPP_INLINE_VISIBILITY size_type length() const _NOEXCEPT {return size();}
976 _LIBCPP_INLINE_VISIBILITY size_type max_size() const _NOEXCEPT;
977 _LIBCPP_INLINE_VISIBILITY size_type capacity() const _NOEXCEPT
Eric Fiselier8599fcc2015-08-28 07:02:42 +0000978 {return (__is_long() ? __get_long_cap()
979 : static_cast<size_type>(__min_cap)) - 1;}
Howard Hinnantc51e1022010-05-11 19:42:16 +0000980
981 void resize(size_type __n, value_type __c);
982 _LIBCPP_INLINE_VISIBILITY void resize(size_type __n) {resize(__n, value_type());}
983
Marek Kurdejc9848142020-11-26 10:07:16 +0100984 void reserve(size_type __requested_capacity);
Eric Fiselier451d5582018-11-26 20:15:38 +0000985 _LIBCPP_INLINE_VISIBILITY void __resize_default_init(size_type __n);
986
Marek Kurdejc9848142020-11-26 10:07:16 +0100987 _LIBCPP_DEPRECATED_IN_CXX20 _LIBCPP_INLINE_VISIBILITY
988 void reserve() _NOEXCEPT {shrink_to_fit();}
Marshall Clow6ae12a82018-11-28 18:18:34 +0000989 _LIBCPP_INLINE_VISIBILITY
Marek Kurdejc9848142020-11-26 10:07:16 +0100990 void shrink_to_fit() _NOEXCEPT;
Howard Hinnantcf823322010-12-17 14:46:43 +0000991 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000992 void clear() _NOEXCEPT;
Marshall Clowb7db4972017-11-15 20:02:27 +0000993 _LIBCPP_NODISCARD_AFTER_CXX17 _LIBCPP_INLINE_VISIBILITY
994 bool empty() const _NOEXCEPT {return size() == 0;}
Howard Hinnantc51e1022010-05-11 19:42:16 +0000995
Marshall Clowdf63a6d2016-07-21 05:31:24 +0000996 _LIBCPP_INLINE_VISIBILITY const_reference operator[](size_type __pos) const _NOEXCEPT;
997 _LIBCPP_INLINE_VISIBILITY reference operator[](size_type __pos) _NOEXCEPT;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000998
999 const_reference at(size_type __n) const;
1000 reference at(size_type __n);
1001
1002 _LIBCPP_INLINE_VISIBILITY basic_string& operator+=(const basic_string& __str) {return append(__str);}
Marshall Clowe46031a2018-07-02 18:41:15 +00001003
1004 template <class _Tp>
1005 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001006 _EnableIf
Marshall Clowe46031a2018-07-02 18:41:15 +00001007 <
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001008 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value
1009 && !__is_same_uncvref<_Tp, basic_string >::value,
Marshall Clowe46031a2018-07-02 18:41:15 +00001010 basic_string&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001011 >
Marshall Clowe46031a2018-07-02 18:41:15 +00001012 operator+=(const _Tp& __t) {__self_view __sv = __t; return append(__sv);}
Marshall Clowdf63a6d2016-07-21 05:31:24 +00001013 _LIBCPP_INLINE_VISIBILITY basic_string& operator+=(const value_type* __s) {return append(__s);}
Howard Hinnantc51e1022010-05-11 19:42:16 +00001014 _LIBCPP_INLINE_VISIBILITY basic_string& operator+=(value_type __c) {push_back(__c); return *this;}
Eric Fiselierfc92be82017-04-19 00:28:44 +00001015#ifndef _LIBCPP_CXX03_LANG
Howard Hinnantc51e1022010-05-11 19:42:16 +00001016 _LIBCPP_INLINE_VISIBILITY basic_string& operator+=(initializer_list<value_type> __il) {return append(__il);}
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04001017#endif // _LIBCPP_CXX03_LANG
Howard Hinnantc51e1022010-05-11 19:42:16 +00001018
Howard Hinnantcf823322010-12-17 14:46:43 +00001019 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00001020 basic_string& append(const basic_string& __str);
Marshall Clowe46031a2018-07-02 18:41:15 +00001021
1022 template <class _Tp>
1023 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001024 _EnableIf<
1025 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value
1026 && !__is_same_uncvref<_Tp, basic_string>::value,
Marshall Clowe46031a2018-07-02 18:41:15 +00001027 basic_string&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001028 >
Marshall Clowe46031a2018-07-02 18:41:15 +00001029 append(const _Tp& __t) { __self_view __sv = __t; return append(__sv.data(), __sv.size()); }
Marshall Clow8db7fb02014-03-04 19:17:19 +00001030 basic_string& append(const basic_string& __str, size_type __pos, size_type __n=npos);
Marshall Clowe46031a2018-07-02 18:41:15 +00001031
Marshall Clow62953962016-10-03 23:40:48 +00001032 template <class _Tp>
Shoaib Meenai69c57412017-03-02 03:02:50 +00001033 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001034 _EnableIf
Marshall Clow82513342016-09-24 22:45:42 +00001035 <
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001036 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value
1037 && !__is_same_uncvref<_Tp, basic_string>::value,
Marshall Clow82513342016-09-24 22:45:42 +00001038 basic_string&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001039 >
Marshall Clow82513342016-09-24 22:45:42 +00001040 append(const _Tp& __t, size_type __pos, size_type __n=npos);
Howard Hinnantd17880b2013-06-28 16:59:19 +00001041 basic_string& append(const value_type* __s, size_type __n);
1042 basic_string& append(const value_type* __s);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001043 basic_string& append(size_type __n, value_type __c);
Eric Fiselier451d5582018-11-26 20:15:38 +00001044
1045 _LIBCPP_INLINE_VISIBILITY
1046 void __append_default_init(size_type __n);
1047
Howard Hinnantc51e1022010-05-11 19:42:16 +00001048 template<class _InputIterator>
Shoaib Meenai69c57412017-03-02 03:02:50 +00001049 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001050 _EnableIf
Howard Hinnantc51e1022010-05-11 19:42:16 +00001051 <
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04001052 __is_exactly_cpp17_input_iterator<_InputIterator>::value,
Howard Hinnantc51e1022010-05-11 19:42:16 +00001053 basic_string&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001054 >
Eric Fiselierdb7ee8f2016-10-31 02:46:25 +00001055 _LIBCPP_INLINE_VISIBILITY
1056 append(_InputIterator __first, _InputIterator __last) {
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04001057 const basic_string __temp(__first, __last, __alloc());
Eric Fiselierdb7ee8f2016-10-31 02:46:25 +00001058 append(__temp.data(), __temp.size());
1059 return *this;
1060 }
Howard Hinnantc51e1022010-05-11 19:42:16 +00001061 template<class _ForwardIterator>
Shoaib Meenai69c57412017-03-02 03:02:50 +00001062 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001063 _EnableIf
Howard Hinnantc51e1022010-05-11 19:42:16 +00001064 <
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04001065 __is_cpp17_forward_iterator<_ForwardIterator>::value,
Howard Hinnantc51e1022010-05-11 19:42:16 +00001066 basic_string&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001067 >
Eric Fiselierdb7ee8f2016-10-31 02:46:25 +00001068 _LIBCPP_INLINE_VISIBILITY
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04001069 append(_ForwardIterator __first, _ForwardIterator __last);
Eric Fiselierdb7ee8f2016-10-31 02:46:25 +00001070
Eric Fiselierfc92be82017-04-19 00:28:44 +00001071#ifndef _LIBCPP_CXX03_LANG
Howard Hinnant186dca82010-09-23 17:31:07 +00001072 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00001073 basic_string& append(initializer_list<value_type> __il) {return append(__il.begin(), __il.size());}
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04001074#endif // _LIBCPP_CXX03_LANG
Howard Hinnantc51e1022010-05-11 19:42:16 +00001075
1076 void push_back(value_type __c);
Howard Hinnantcf823322010-12-17 14:46:43 +00001077 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00001078 void pop_back();
Marshall Clow05cf6692019-03-19 03:30:07 +00001079 _LIBCPP_INLINE_VISIBILITY reference front() _NOEXCEPT;
1080 _LIBCPP_INLINE_VISIBILITY const_reference front() const _NOEXCEPT;
1081 _LIBCPP_INLINE_VISIBILITY reference back() _NOEXCEPT;
1082 _LIBCPP_INLINE_VISIBILITY const_reference back() const _NOEXCEPT;
Howard Hinnantc51e1022010-05-11 19:42:16 +00001083
Marshall Clowe46031a2018-07-02 18:41:15 +00001084 template <class _Tp>
1085 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001086 _EnableIf
Marshall Clowe46031a2018-07-02 18:41:15 +00001087 <
1088 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
1089 basic_string&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001090 >
Marshall Clowe46031a2018-07-02 18:41:15 +00001091 assign(const _Tp & __t) { __self_view __sv = __t; return assign(__sv.data(), __sv.size()); }
Marshall Clowdf63a6d2016-07-21 05:31:24 +00001092 _LIBCPP_INLINE_VISIBILITY
Marshall Clow95d5e9a2016-03-09 18:08:29 +00001093 basic_string& assign(const basic_string& __str) { return *this = __str; }
Eric Fiselierfc92be82017-04-19 00:28:44 +00001094#ifndef _LIBCPP_CXX03_LANG
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001095 _LIBCPP_INLINE_VISIBILITY
Eric Fiselierc5ea1ae2017-06-01 02:29:37 +00001096 basic_string& assign(basic_string&& __str)
Marshall Clow5aa9e942015-10-05 16:17:34 +00001097 _NOEXCEPT_((__noexcept_move_assign_container<_Allocator, __alloc_traits>::value))
Eric Fiselierc5ea1ae2017-06-01 02:29:37 +00001098 {*this = _VSTD::move(__str); return *this;}
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001099#endif
Marshall Clow8db7fb02014-03-04 19:17:19 +00001100 basic_string& assign(const basic_string& __str, size_type __pos, size_type __n=npos);
Marshall Clow62953962016-10-03 23:40:48 +00001101 template <class _Tp>
Shoaib Meenai69c57412017-03-02 03:02:50 +00001102 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001103 _EnableIf
Marshall Clow82513342016-09-24 22:45:42 +00001104 <
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001105 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value
1106 && !__is_same_uncvref<_Tp, basic_string>::value,
Marshall Clow82513342016-09-24 22:45:42 +00001107 basic_string&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001108 >
Eric Fiselierc5ea1ae2017-06-01 02:29:37 +00001109 assign(const _Tp & __t, size_type __pos, size_type __n=npos);
Howard Hinnantd17880b2013-06-28 16:59:19 +00001110 basic_string& assign(const value_type* __s, size_type __n);
1111 basic_string& assign(const value_type* __s);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001112 basic_string& assign(size_type __n, value_type __c);
1113 template<class _InputIterator>
Shoaib Meenai69c57412017-03-02 03:02:50 +00001114 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001115 _EnableIf
Howard Hinnantc51e1022010-05-11 19:42:16 +00001116 <
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04001117 __is_exactly_cpp17_input_iterator<_InputIterator>::value,
Howard Hinnantc51e1022010-05-11 19:42:16 +00001118 basic_string&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001119 >
Howard Hinnantc51e1022010-05-11 19:42:16 +00001120 assign(_InputIterator __first, _InputIterator __last);
1121 template<class _ForwardIterator>
Shoaib Meenai69c57412017-03-02 03:02:50 +00001122 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001123 _EnableIf
Howard Hinnantc51e1022010-05-11 19:42:16 +00001124 <
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04001125 __is_cpp17_forward_iterator<_ForwardIterator>::value,
Howard Hinnantc51e1022010-05-11 19:42:16 +00001126 basic_string&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001127 >
Howard Hinnantc51e1022010-05-11 19:42:16 +00001128 assign(_ForwardIterator __first, _ForwardIterator __last);
Eric Fiselierfc92be82017-04-19 00:28:44 +00001129#ifndef _LIBCPP_CXX03_LANG
Howard Hinnant186dca82010-09-23 17:31:07 +00001130 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00001131 basic_string& assign(initializer_list<value_type> __il) {return assign(__il.begin(), __il.size());}
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04001132#endif // _LIBCPP_CXX03_LANG
Howard Hinnantc51e1022010-05-11 19:42:16 +00001133
Howard Hinnantcf823322010-12-17 14:46:43 +00001134 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00001135 basic_string& insert(size_type __pos1, const basic_string& __str);
Marshall Clowe46031a2018-07-02 18:41:15 +00001136
1137 template <class _Tp>
1138 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001139 _EnableIf
Marshall Clowe46031a2018-07-02 18:41:15 +00001140 <
1141 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
1142 basic_string&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001143 >
Marshall Clowe46031a2018-07-02 18:41:15 +00001144 insert(size_type __pos1, const _Tp& __t)
1145 { __self_view __sv = __t; return insert(__pos1, __sv.data(), __sv.size()); }
1146
Marshall Clow82513342016-09-24 22:45:42 +00001147 template <class _Tp>
Shoaib Meenai69c57412017-03-02 03:02:50 +00001148 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001149 _EnableIf
Marshall Clow82513342016-09-24 22:45:42 +00001150 <
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001151 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value && !__is_same_uncvref<_Tp, basic_string>::value,
Marshall Clow82513342016-09-24 22:45:42 +00001152 basic_string&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001153 >
Marshall Clow82513342016-09-24 22:45:42 +00001154 insert(size_type __pos1, const _Tp& __t, size_type __pos2, size_type __n=npos);
Marshall Clow8db7fb02014-03-04 19:17:19 +00001155 basic_string& insert(size_type __pos1, const basic_string& __str, size_type __pos2, size_type __n=npos);
Howard Hinnantd17880b2013-06-28 16:59:19 +00001156 basic_string& insert(size_type __pos, const value_type* __s, size_type __n);
1157 basic_string& insert(size_type __pos, const value_type* __s);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001158 basic_string& insert(size_type __pos, size_type __n, value_type __c);
1159 iterator insert(const_iterator __pos, value_type __c);
Howard Hinnantcf823322010-12-17 14:46:43 +00001160 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00001161 iterator insert(const_iterator __pos, size_type __n, value_type __c);
1162 template<class _InputIterator>
Shoaib Meenai69c57412017-03-02 03:02:50 +00001163 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001164 _EnableIf
Howard Hinnantc51e1022010-05-11 19:42:16 +00001165 <
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04001166 __is_exactly_cpp17_input_iterator<_InputIterator>::value,
Howard Hinnantc51e1022010-05-11 19:42:16 +00001167 iterator
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001168 >
Howard Hinnantc51e1022010-05-11 19:42:16 +00001169 insert(const_iterator __pos, _InputIterator __first, _InputIterator __last);
1170 template<class _ForwardIterator>
Shoaib Meenai69c57412017-03-02 03:02:50 +00001171 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001172 _EnableIf
Howard Hinnantc51e1022010-05-11 19:42:16 +00001173 <
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04001174 __is_cpp17_forward_iterator<_ForwardIterator>::value,
Howard Hinnantc51e1022010-05-11 19:42:16 +00001175 iterator
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001176 >
Howard Hinnantc51e1022010-05-11 19:42:16 +00001177 insert(const_iterator __pos, _ForwardIterator __first, _ForwardIterator __last);
Eric Fiselierfc92be82017-04-19 00:28:44 +00001178#ifndef _LIBCPP_CXX03_LANG
Howard Hinnant186dca82010-09-23 17:31:07 +00001179 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00001180 iterator insert(const_iterator __pos, initializer_list<value_type> __il)
1181 {return insert(__pos, __il.begin(), __il.end());}
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04001182#endif // _LIBCPP_CXX03_LANG
Howard Hinnantc51e1022010-05-11 19:42:16 +00001183
1184 basic_string& erase(size_type __pos = 0, size_type __n = npos);
Howard Hinnantcf823322010-12-17 14:46:43 +00001185 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00001186 iterator erase(const_iterator __pos);
Howard Hinnantcf823322010-12-17 14:46:43 +00001187 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00001188 iterator erase(const_iterator __first, const_iterator __last);
1189
Howard Hinnantcf823322010-12-17 14:46:43 +00001190 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00001191 basic_string& replace(size_type __pos1, size_type __n1, const basic_string& __str);
Marshall Clowe46031a2018-07-02 18:41:15 +00001192
1193 template <class _Tp>
1194 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001195 _EnableIf
Marshall Clowe46031a2018-07-02 18:41:15 +00001196 <
1197 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
1198 basic_string&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001199 >
Marshall Clowe46031a2018-07-02 18:41:15 +00001200 replace(size_type __pos1, size_type __n1, const _Tp& __t) { __self_view __sv = __t; return replace(__pos1, __n1, __sv.data(), __sv.size()); }
Marshall Clow8db7fb02014-03-04 19:17:19 +00001201 basic_string& replace(size_type __pos1, size_type __n1, const basic_string& __str, size_type __pos2, size_type __n2=npos);
Marshall Clow82513342016-09-24 22:45:42 +00001202 template <class _Tp>
Shoaib Meenai69c57412017-03-02 03:02:50 +00001203 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001204 _EnableIf
Marshall Clow82513342016-09-24 22:45:42 +00001205 <
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001206 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value && !__is_same_uncvref<_Tp, basic_string>::value,
Marshall Clow82513342016-09-24 22:45:42 +00001207 basic_string&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001208 >
Marshall Clow82513342016-09-24 22:45:42 +00001209 replace(size_type __pos1, size_type __n1, const _Tp& __t, size_type __pos2, size_type __n2=npos);
Howard Hinnantd17880b2013-06-28 16:59:19 +00001210 basic_string& replace(size_type __pos, size_type __n1, const value_type* __s, size_type __n2);
1211 basic_string& replace(size_type __pos, size_type __n1, const value_type* __s);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001212 basic_string& replace(size_type __pos, size_type __n1, size_type __n2, value_type __c);
Howard Hinnantcf823322010-12-17 14:46:43 +00001213 _LIBCPP_INLINE_VISIBILITY
Howard Hinnant990d6e82010-11-17 21:11:40 +00001214 basic_string& replace(const_iterator __i1, const_iterator __i2, const basic_string& __str);
Marshall Clowe46031a2018-07-02 18:41:15 +00001215
1216 template <class _Tp>
1217 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001218 _EnableIf
Marshall Clowe46031a2018-07-02 18:41:15 +00001219 <
1220 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
1221 basic_string&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001222 >
Marshall Clowe46031a2018-07-02 18:41:15 +00001223 replace(const_iterator __i1, const_iterator __i2, const _Tp& __t) { __self_view __sv = __t; return replace(__i1 - begin(), __i2 - __i1, __sv); }
1224
Marshall Clowdf63a6d2016-07-21 05:31:24 +00001225 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantd17880b2013-06-28 16:59:19 +00001226 basic_string& replace(const_iterator __i1, const_iterator __i2, const value_type* __s, size_type __n);
Howard Hinnantcf823322010-12-17 14:46:43 +00001227 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantd17880b2013-06-28 16:59:19 +00001228 basic_string& replace(const_iterator __i1, const_iterator __i2, const value_type* __s);
Howard Hinnantcf823322010-12-17 14:46:43 +00001229 _LIBCPP_INLINE_VISIBILITY
Howard Hinnant990d6e82010-11-17 21:11:40 +00001230 basic_string& replace(const_iterator __i1, const_iterator __i2, size_type __n, value_type __c);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001231 template<class _InputIterator>
Shoaib Meenai69c57412017-03-02 03:02:50 +00001232 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001233 _EnableIf
Howard Hinnantc51e1022010-05-11 19:42:16 +00001234 <
Eric Fiseliercd5a6772019-11-18 01:46:58 -05001235 __is_cpp17_input_iterator<_InputIterator>::value,
Howard Hinnantc51e1022010-05-11 19:42:16 +00001236 basic_string&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001237 >
Howard Hinnant990d6e82010-11-17 21:11:40 +00001238 replace(const_iterator __i1, const_iterator __i2, _InputIterator __j1, _InputIterator __j2);
Eric Fiselierfc92be82017-04-19 00:28:44 +00001239#ifndef _LIBCPP_CXX03_LANG
Howard Hinnant186dca82010-09-23 17:31:07 +00001240 _LIBCPP_INLINE_VISIBILITY
Howard Hinnant990d6e82010-11-17 21:11:40 +00001241 basic_string& replace(const_iterator __i1, const_iterator __i2, initializer_list<value_type> __il)
Howard Hinnantc51e1022010-05-11 19:42:16 +00001242 {return replace(__i1, __i2, __il.begin(), __il.end());}
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04001243#endif // _LIBCPP_CXX03_LANG
Howard Hinnantc51e1022010-05-11 19:42:16 +00001244
Howard Hinnantd17880b2013-06-28 16:59:19 +00001245 size_type copy(value_type* __s, size_type __n, size_type __pos = 0) const;
Howard Hinnantcf823322010-12-17 14:46:43 +00001246 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00001247 basic_string substr(size_type __pos = 0, size_type __n = npos) const;
1248
Howard Hinnantcf823322010-12-17 14:46:43 +00001249 _LIBCPP_INLINE_VISIBILITY
Howard Hinnant3e276872011-06-03 18:40:47 +00001250 void swap(basic_string& __str)
Marshall Clow8982dcd2015-07-13 20:04:56 +00001251#if _LIBCPP_STD_VER >= 14
Eric Fiselier873b8d32019-03-18 21:50:12 +00001252 _NOEXCEPT;
Marshall Clow8982dcd2015-07-13 20:04:56 +00001253#else
Eric Fiselier873b8d32019-03-18 21:50:12 +00001254 _NOEXCEPT_(!__alloc_traits::propagate_on_container_swap::value ||
Marshall Clow8982dcd2015-07-13 20:04:56 +00001255 __is_nothrow_swappable<allocator_type>::value);
1256#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +00001257
Howard Hinnantcf823322010-12-17 14:46:43 +00001258 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantd17880b2013-06-28 16:59:19 +00001259 const value_type* c_str() const _NOEXCEPT {return data();}
Howard Hinnantcf823322010-12-17 14:46:43 +00001260 _LIBCPP_INLINE_VISIBILITY
Eric Fiselierc1b87a72019-11-16 17:13:26 -05001261 const value_type* data() const _NOEXCEPT {return _VSTD::__to_address(__get_pointer());}
Eric Fiselier4ee2a892017-11-20 20:23:27 +00001262#if _LIBCPP_STD_VER > 14 || defined(_LIBCPP_BUILDING_LIBRARY)
Marshall Clowd3c22392016-03-08 15:44:30 +00001263 _LIBCPP_INLINE_VISIBILITY
Eric Fiselierc1b87a72019-11-16 17:13:26 -05001264 value_type* data() _NOEXCEPT {return _VSTD::__to_address(__get_pointer());}
Marshall Clowd3c22392016-03-08 15:44:30 +00001265#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +00001266
Howard Hinnantcf823322010-12-17 14:46:43 +00001267 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001268 allocator_type get_allocator() const _NOEXCEPT {return __alloc();}
Howard Hinnantc51e1022010-05-11 19:42:16 +00001269
Howard Hinnantcf823322010-12-17 14:46:43 +00001270 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001271 size_type find(const basic_string& __str, size_type __pos = 0) const _NOEXCEPT;
Marshall Clowe46031a2018-07-02 18:41:15 +00001272
1273 template <class _Tp>
1274 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001275 _EnableIf
Marshall Clowe46031a2018-07-02 18:41:15 +00001276 <
1277 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
1278 size_type
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001279 >
zoecarver1997e0a2021-02-05 11:54:47 -08001280 find(const _Tp& __t, size_type __pos = 0) const _NOEXCEPT;
Howard Hinnantd17880b2013-06-28 16:59:19 +00001281 size_type find(const value_type* __s, size_type __pos, size_type __n) const _NOEXCEPT;
Howard Hinnantcf823322010-12-17 14:46:43 +00001282 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantd17880b2013-06-28 16:59:19 +00001283 size_type find(const value_type* __s, size_type __pos = 0) const _NOEXCEPT;
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001284 size_type find(value_type __c, size_type __pos = 0) const _NOEXCEPT;
Howard Hinnantc51e1022010-05-11 19:42:16 +00001285
Howard Hinnantcf823322010-12-17 14:46:43 +00001286 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001287 size_type rfind(const basic_string& __str, size_type __pos = npos) const _NOEXCEPT;
Marshall Clowe46031a2018-07-02 18:41:15 +00001288
1289 template <class _Tp>
1290 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001291 _EnableIf
Marshall Clowe46031a2018-07-02 18:41:15 +00001292 <
1293 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
1294 size_type
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001295 >
zoecarver1997e0a2021-02-05 11:54:47 -08001296 rfind(const _Tp& __t, size_type __pos = npos) const _NOEXCEPT;
Howard Hinnantd17880b2013-06-28 16:59:19 +00001297 size_type rfind(const value_type* __s, size_type __pos, size_type __n) const _NOEXCEPT;
Howard Hinnantcf823322010-12-17 14:46:43 +00001298 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantd17880b2013-06-28 16:59:19 +00001299 size_type rfind(const value_type* __s, size_type __pos = npos) const _NOEXCEPT;
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001300 size_type rfind(value_type __c, size_type __pos = npos) const _NOEXCEPT;
Howard Hinnantc51e1022010-05-11 19:42:16 +00001301
Howard Hinnantcf823322010-12-17 14:46:43 +00001302 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001303 size_type find_first_of(const basic_string& __str, size_type __pos = 0) const _NOEXCEPT;
Marshall Clowe46031a2018-07-02 18:41:15 +00001304
1305 template <class _Tp>
1306 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001307 _EnableIf
Marshall Clowe46031a2018-07-02 18:41:15 +00001308 <
1309 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
1310 size_type
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001311 >
zoecarver1997e0a2021-02-05 11:54:47 -08001312 find_first_of(const _Tp& __t, size_type __pos = 0) const _NOEXCEPT;
Howard Hinnantd17880b2013-06-28 16:59:19 +00001313 size_type find_first_of(const value_type* __s, size_type __pos, size_type __n) const _NOEXCEPT;
Howard Hinnantcf823322010-12-17 14:46:43 +00001314 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantd17880b2013-06-28 16:59:19 +00001315 size_type find_first_of(const value_type* __s, size_type __pos = 0) const _NOEXCEPT;
Howard Hinnantcf823322010-12-17 14:46:43 +00001316 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001317 size_type find_first_of(value_type __c, size_type __pos = 0) const _NOEXCEPT;
Howard Hinnantc51e1022010-05-11 19:42:16 +00001318
Howard Hinnantcf823322010-12-17 14:46:43 +00001319 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001320 size_type find_last_of(const basic_string& __str, size_type __pos = npos) const _NOEXCEPT;
Marshall Clowe46031a2018-07-02 18:41:15 +00001321
1322 template <class _Tp>
1323 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001324 _EnableIf
Marshall Clowe46031a2018-07-02 18:41:15 +00001325 <
1326 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
1327 size_type
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001328 >
zoecarver1997e0a2021-02-05 11:54:47 -08001329 find_last_of(const _Tp& __t, size_type __pos = npos) const _NOEXCEPT;
Howard Hinnantd17880b2013-06-28 16:59:19 +00001330 size_type find_last_of(const value_type* __s, size_type __pos, size_type __n) const _NOEXCEPT;
Howard Hinnantcf823322010-12-17 14:46:43 +00001331 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantd17880b2013-06-28 16:59:19 +00001332 size_type find_last_of(const value_type* __s, size_type __pos = npos) const _NOEXCEPT;
Howard Hinnantcf823322010-12-17 14:46:43 +00001333 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001334 size_type find_last_of(value_type __c, size_type __pos = npos) const _NOEXCEPT;
Howard Hinnantc51e1022010-05-11 19:42:16 +00001335
Howard Hinnantcf823322010-12-17 14:46:43 +00001336 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001337 size_type find_first_not_of(const basic_string& __str, size_type __pos = 0) const _NOEXCEPT;
Marshall Clowe46031a2018-07-02 18:41:15 +00001338
1339 template <class _Tp>
1340 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001341 _EnableIf
Marshall Clowe46031a2018-07-02 18:41:15 +00001342 <
1343 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
1344 size_type
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001345 >
zoecarver1997e0a2021-02-05 11:54:47 -08001346 find_first_not_of(const _Tp &__t, size_type __pos = 0) const _NOEXCEPT;
Howard Hinnantd17880b2013-06-28 16:59:19 +00001347 size_type find_first_not_of(const value_type* __s, size_type __pos, size_type __n) const _NOEXCEPT;
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001348 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantd17880b2013-06-28 16:59:19 +00001349 size_type find_first_not_of(const value_type* __s, size_type __pos = 0) const _NOEXCEPT;
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001350 _LIBCPP_INLINE_VISIBILITY
1351 size_type find_first_not_of(value_type __c, size_type __pos = 0) const _NOEXCEPT;
1352
1353 _LIBCPP_INLINE_VISIBILITY
1354 size_type find_last_not_of(const basic_string& __str, size_type __pos = npos) const _NOEXCEPT;
Marshall Clowe46031a2018-07-02 18:41:15 +00001355
1356 template <class _Tp>
1357 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001358 _EnableIf
Marshall Clowe46031a2018-07-02 18:41:15 +00001359 <
1360 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
1361 size_type
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001362 >
zoecarver1997e0a2021-02-05 11:54:47 -08001363 find_last_not_of(const _Tp& __t, size_type __pos = npos) const _NOEXCEPT;
Howard Hinnantd17880b2013-06-28 16:59:19 +00001364 size_type find_last_not_of(const value_type* __s, size_type __pos, size_type __n) const _NOEXCEPT;
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001365 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantd17880b2013-06-28 16:59:19 +00001366 size_type find_last_not_of(const value_type* __s, size_type __pos = npos) const _NOEXCEPT;
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001367 _LIBCPP_INLINE_VISIBILITY
1368 size_type find_last_not_of(value_type __c, size_type __pos = npos) const _NOEXCEPT;
1369
1370 _LIBCPP_INLINE_VISIBILITY
1371 int compare(const basic_string& __str) const _NOEXCEPT;
Marshall Clowe46031a2018-07-02 18:41:15 +00001372
1373 template <class _Tp>
1374 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001375 _EnableIf
Marshall Clowe46031a2018-07-02 18:41:15 +00001376 <
1377 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
1378 int
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001379 >
zoecarver1997e0a2021-02-05 11:54:47 -08001380 compare(const _Tp &__t) const _NOEXCEPT;
Marshall Clowe46031a2018-07-02 18:41:15 +00001381
1382 template <class _Tp>
1383 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001384 _EnableIf
Marshall Clowe46031a2018-07-02 18:41:15 +00001385 <
1386 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
1387 int
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001388 >
Marshall Clowe46031a2018-07-02 18:41:15 +00001389 compare(size_type __pos1, size_type __n1, const _Tp& __t) const;
1390
Marshall Clowdf63a6d2016-07-21 05:31:24 +00001391 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00001392 int compare(size_type __pos1, size_type __n1, const basic_string& __str) const;
Marshall Clow8db7fb02014-03-04 19:17:19 +00001393 int compare(size_type __pos1, size_type __n1, const basic_string& __str, size_type __pos2, size_type __n2=npos) const;
Marshall Clowe46031a2018-07-02 18:41:15 +00001394
Marshall Clow82513342016-09-24 22:45:42 +00001395 template <class _Tp>
Eric Fiselier7d4aa5c2016-10-14 05:29:46 +00001396 inline _LIBCPP_INLINE_VISIBILITY
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001397 _EnableIf
Marshall Clow82513342016-09-24 22:45:42 +00001398 <
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001399 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value && !__is_same_uncvref<_Tp, basic_string>::value,
Marshall Clow82513342016-09-24 22:45:42 +00001400 int
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001401 >
Marshall Clow82513342016-09-24 22:45:42 +00001402 compare(size_type __pos1, size_type __n1, const _Tp& __t, size_type __pos2, size_type __n2=npos) const;
Howard Hinnantd17880b2013-06-28 16:59:19 +00001403 int compare(const value_type* __s) const _NOEXCEPT;
1404 int compare(size_type __pos1, size_type __n1, const value_type* __s) const;
1405 int compare(size_type __pos1, size_type __n1, const value_type* __s, size_type __n2) const;
Howard Hinnantc51e1022010-05-11 19:42:16 +00001406
Marshall Clow18c293b2017-12-04 20:11:38 +00001407#if _LIBCPP_STD_VER > 17
1408 _LIBCPP_CONSTEXPR_AFTER_CXX11 _LIBCPP_INLINE_VISIBILITY
1409 bool starts_with(__self_view __sv) const _NOEXCEPT
1410 { return __self_view(data(), size()).starts_with(__sv); }
1411
1412 _LIBCPP_CONSTEXPR_AFTER_CXX11 _LIBCPP_INLINE_VISIBILITY
1413 bool starts_with(value_type __c) const _NOEXCEPT
1414 { return !empty() && _Traits::eq(front(), __c); }
1415
1416 _LIBCPP_CONSTEXPR_AFTER_CXX11 _LIBCPP_INLINE_VISIBILITY
1417 bool starts_with(const value_type* __s) const _NOEXCEPT
1418 { return starts_with(__self_view(__s)); }
1419
1420 _LIBCPP_CONSTEXPR_AFTER_CXX11 _LIBCPP_INLINE_VISIBILITY
1421 bool ends_with(__self_view __sv) const _NOEXCEPT
1422 { return __self_view(data(), size()).ends_with( __sv); }
1423
1424 _LIBCPP_CONSTEXPR_AFTER_CXX11 _LIBCPP_INLINE_VISIBILITY
1425 bool ends_with(value_type __c) const _NOEXCEPT
1426 { return !empty() && _Traits::eq(back(), __c); }
1427
1428 _LIBCPP_CONSTEXPR_AFTER_CXX11 _LIBCPP_INLINE_VISIBILITY
1429 bool ends_with(const value_type* __s) const _NOEXCEPT
1430 { return ends_with(__self_view(__s)); }
1431#endif
1432
Wim Leflere023c3542021-01-19 14:33:30 -05001433#if _LIBCPP_STD_VER > 20
1434 constexpr _LIBCPP_INLINE_VISIBILITY
1435 bool contains(__self_view __sv) const noexcept
1436 { return __self_view(data(), size()).contains(__sv); }
1437
1438 constexpr _LIBCPP_INLINE_VISIBILITY
1439 bool contains(value_type __c) const noexcept
1440 { return __self_view(data(), size()).contains(__c); }
1441
1442 constexpr _LIBCPP_INLINE_VISIBILITY
1443 bool contains(const value_type* __s) const
1444 { return __self_view(data(), size()).contains(__s); }
1445#endif
1446
Howard Hinnantcf823322010-12-17 14:46:43 +00001447 _LIBCPP_INLINE_VISIBILITY bool __invariants() const;
Howard Hinnantaaeb1132013-04-22 23:55:13 +00001448
Marshall Clowe60a7182018-05-29 17:04:37 +00001449 _LIBCPP_INLINE_VISIBILITY void __clear_and_shrink() _NOEXCEPT;
Marshall Clow851b9ec2019-05-20 21:56:51 +00001450
Marek Kurdejc9848142020-11-26 10:07:16 +01001451 _LIBCPP_INLINE_VISIBILITY void __shrink_or_extend(size_type __target_capacity);
1452
Howard Hinnantaaeb1132013-04-22 23:55:13 +00001453 _LIBCPP_INLINE_VISIBILITY
1454 bool __is_long() const _NOEXCEPT
1455 {return bool(__r_.first().__s.__size_ & __short_mask);}
1456
Louis Dionneba400782020-10-02 15:02:52 -04001457#if _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnant8ea98242013-08-23 17:37:05 +00001458
1459 bool __dereferenceable(const const_iterator* __i) const;
1460 bool __decrementable(const const_iterator* __i) const;
1461 bool __addable(const const_iterator* __i, ptrdiff_t __n) const;
1462 bool __subscriptable(const const_iterator* __i, ptrdiff_t __n) const;
1463
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04001464#endif // _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnant8ea98242013-08-23 17:37:05 +00001465
Howard Hinnantc51e1022010-05-11 19:42:16 +00001466private:
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001467 _LIBCPP_INLINE_VISIBILITY
1468 allocator_type& __alloc() _NOEXCEPT
1469 {return __r_.second();}
1470 _LIBCPP_INLINE_VISIBILITY
1471 const allocator_type& __alloc() const _NOEXCEPT
1472 {return __r_.second();}
Howard Hinnantc51e1022010-05-11 19:42:16 +00001473
Evgeniy Stepanovda2ff7e2015-10-13 23:48:28 +00001474#ifdef _LIBCPP_ABI_ALTERNATE_STRING_LAYOUT
Howard Hinnant68bf1812013-04-30 21:44:48 +00001475
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001476 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001477 void __set_short_size(size_type __s) _NOEXCEPT
Eric Fiseliere9cc5922017-10-17 13:16:01 +00001478# ifdef _LIBCPP_BIG_ENDIAN
Howard Hinnantc51e1022010-05-11 19:42:16 +00001479 {__r_.first().__s.__size_ = (unsigned char)(__s << 1);}
Howard Hinnant68bf1812013-04-30 21:44:48 +00001480# else
1481 {__r_.first().__s.__size_ = (unsigned char)(__s);}
1482# endif
1483
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001484 _LIBCPP_INLINE_VISIBILITY
1485 size_type __get_short_size() const _NOEXCEPT
Eric Fiseliere9cc5922017-10-17 13:16:01 +00001486# ifdef _LIBCPP_BIG_ENDIAN
Howard Hinnantc51e1022010-05-11 19:42:16 +00001487 {return __r_.first().__s.__size_ >> 1;}
Howard Hinnant68bf1812013-04-30 21:44:48 +00001488# else
1489 {return __r_.first().__s.__size_;}
1490# endif
1491
Evgeniy Stepanovda2ff7e2015-10-13 23:48:28 +00001492#else // _LIBCPP_ABI_ALTERNATE_STRING_LAYOUT
Howard Hinnant68bf1812013-04-30 21:44:48 +00001493
1494 _LIBCPP_INLINE_VISIBILITY
1495 void __set_short_size(size_type __s) _NOEXCEPT
Eric Fiseliere9cc5922017-10-17 13:16:01 +00001496# ifdef _LIBCPP_BIG_ENDIAN
Howard Hinnant68bf1812013-04-30 21:44:48 +00001497 {__r_.first().__s.__size_ = (unsigned char)(__s);}
1498# else
1499 {__r_.first().__s.__size_ = (unsigned char)(__s << 1);}
1500# endif
1501
1502 _LIBCPP_INLINE_VISIBILITY
1503 size_type __get_short_size() const _NOEXCEPT
Eric Fiseliere9cc5922017-10-17 13:16:01 +00001504# ifdef _LIBCPP_BIG_ENDIAN
Howard Hinnant68bf1812013-04-30 21:44:48 +00001505 {return __r_.first().__s.__size_;}
1506# else
1507 {return __r_.first().__s.__size_ >> 1;}
1508# endif
1509
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04001510#endif // _LIBCPP_ABI_ALTERNATE_STRING_LAYOUT
Howard Hinnant68bf1812013-04-30 21:44:48 +00001511
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001512 _LIBCPP_INLINE_VISIBILITY
1513 void __set_long_size(size_type __s) _NOEXCEPT
1514 {__r_.first().__l.__size_ = __s;}
1515 _LIBCPP_INLINE_VISIBILITY
1516 size_type __get_long_size() const _NOEXCEPT
1517 {return __r_.first().__l.__size_;}
1518 _LIBCPP_INLINE_VISIBILITY
1519 void __set_size(size_type __s) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00001520 {if (__is_long()) __set_long_size(__s); else __set_short_size(__s);}
1521
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001522 _LIBCPP_INLINE_VISIBILITY
1523 void __set_long_cap(size_type __s) _NOEXCEPT
1524 {__r_.first().__l.__cap_ = __long_mask | __s;}
1525 _LIBCPP_INLINE_VISIBILITY
1526 size_type __get_long_cap() const _NOEXCEPT
Howard Hinnant28b24882011-12-01 20:21:04 +00001527 {return __r_.first().__l.__cap_ & size_type(~__long_mask);}
Howard Hinnantc51e1022010-05-11 19:42:16 +00001528
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001529 _LIBCPP_INLINE_VISIBILITY
1530 void __set_long_pointer(pointer __p) _NOEXCEPT
1531 {__r_.first().__l.__data_ = __p;}
1532 _LIBCPP_INLINE_VISIBILITY
1533 pointer __get_long_pointer() _NOEXCEPT
1534 {return __r_.first().__l.__data_;}
1535 _LIBCPP_INLINE_VISIBILITY
1536 const_pointer __get_long_pointer() const _NOEXCEPT
1537 {return __r_.first().__l.__data_;}
1538 _LIBCPP_INLINE_VISIBILITY
1539 pointer __get_short_pointer() _NOEXCEPT
Howard Hinnantd17880b2013-06-28 16:59:19 +00001540 {return pointer_traits<pointer>::pointer_to(__r_.first().__s.__data_[0]);}
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001541 _LIBCPP_INLINE_VISIBILITY
1542 const_pointer __get_short_pointer() const _NOEXCEPT
Howard Hinnantd17880b2013-06-28 16:59:19 +00001543 {return pointer_traits<const_pointer>::pointer_to(__r_.first().__s.__data_[0]);}
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001544 _LIBCPP_INLINE_VISIBILITY
1545 pointer __get_pointer() _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00001546 {return __is_long() ? __get_long_pointer() : __get_short_pointer();}
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001547 _LIBCPP_INLINE_VISIBILITY
1548 const_pointer __get_pointer() const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00001549 {return __is_long() ? __get_long_pointer() : __get_short_pointer();}
1550
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001551 _LIBCPP_INLINE_VISIBILITY
1552 void __zero() _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00001553 {
1554 size_type (&__a)[__n_words] = __r_.first().__r.__words;
1555 for (unsigned __i = 0; __i < __n_words; ++__i)
1556 __a[__i] = 0;
1557 }
1558
1559 template <size_type __a> static
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001560 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantea382952013-08-14 18:00:20 +00001561 size_type __align_it(size_type __s) _NOEXCEPT
Eric Fiselier8599fcc2015-08-28 07:02:42 +00001562 {return (__s + (__a-1)) & ~(__a-1);}
Howard Hinnantc51e1022010-05-11 19:42:16 +00001563 enum {__alignment = 16};
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001564 static _LIBCPP_INLINE_VISIBILITY
1565 size_type __recommend(size_type __s) _NOEXCEPT
Marshall Clow80584522018-02-07 21:30:17 +00001566 {
1567 if (__s < __min_cap) return static_cast<size_type>(__min_cap) - 1;
1568 size_type __guess = __align_it<sizeof(value_type) < __alignment ?
1569 __alignment/sizeof(value_type) : 1 > (__s+1) - 1;
1570 if (__guess == __min_cap) ++__guess;
1571 return __guess;
1572 }
Howard Hinnantc51e1022010-05-11 19:42:16 +00001573
Duncan P. N. Exon Smitheb584632017-04-01 03:20:48 +00001574 inline
Howard Hinnantd17880b2013-06-28 16:59:19 +00001575 void __init(const value_type* __s, size_type __sz, size_type __reserve);
Duncan P. N. Exon Smitheb584632017-04-01 03:20:48 +00001576 inline
Howard Hinnantd17880b2013-06-28 16:59:19 +00001577 void __init(const value_type* __s, size_type __sz);
Duncan P. N. Exon Smitheb584632017-04-01 03:20:48 +00001578 inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00001579 void __init(size_type __n, value_type __c);
Howard Hinnant3b6579a2010-08-22 00:02:43 +00001580
Martijn Vels5e7c9752020-03-04 17:52:46 -05001581 // Slow path for the (inlined) copy constructor for 'long' strings.
1582 // Always externally instantiated and not inlined.
1583 // Requires that __s is zero terminated.
1584 // The main reason for this function to exist is because for unstable, we
1585 // want to allow inlining of the copy constructor. However, we don't want
1586 // to call the __init() functions as those are marked as inline which may
1587 // result in over-aggressive inlining by the compiler, where our aim is
1588 // to only inline the fast path code directly in the ctor.
1589 void __init_copy_ctor_external(const value_type* __s, size_type __sz);
1590
Howard Hinnantc51e1022010-05-11 19:42:16 +00001591 template <class _InputIterator>
Duncan P. N. Exon Smitheb584632017-04-01 03:20:48 +00001592 inline
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001593 _EnableIf
Howard Hinnantc51e1022010-05-11 19:42:16 +00001594 <
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001595 __is_exactly_cpp17_input_iterator<_InputIterator>::value
1596 >
Howard Hinnantc51e1022010-05-11 19:42:16 +00001597 __init(_InputIterator __first, _InputIterator __last);
1598
1599 template <class _ForwardIterator>
Duncan P. N. Exon Smitheb584632017-04-01 03:20:48 +00001600 inline
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001601 _EnableIf
Howard Hinnantc51e1022010-05-11 19:42:16 +00001602 <
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001603 __is_cpp17_forward_iterator<_ForwardIterator>::value
1604 >
Howard Hinnantc51e1022010-05-11 19:42:16 +00001605 __init(_ForwardIterator __first, _ForwardIterator __last);
1606
1607 void __grow_by(size_type __old_cap, size_type __delta_cap, size_type __old_sz,
Howard Hinnant3b6579a2010-08-22 00:02:43 +00001608 size_type __n_copy, size_type __n_del, size_type __n_add = 0);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001609 void __grow_by_and_replace(size_type __old_cap, size_type __delta_cap, size_type __old_sz,
1610 size_type __n_copy, size_type __n_del,
Howard Hinnantd17880b2013-06-28 16:59:19 +00001611 size_type __n_add, const value_type* __p_new_stuff);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001612
Martijn Vels596e3de2020-02-26 15:55:49 -05001613 // __assign_no_alias is invoked for assignment operations where we
1614 // have proof that the input does not alias the current instance.
1615 // For example, operator=(basic_string) performs a 'self' check.
1616 template <bool __is_short>
Martijn Velsb6a08b62020-04-10 18:36:31 -04001617 basic_string& __assign_no_alias(const value_type* __s, size_type __n);
Martijn Vels596e3de2020-02-26 15:55:49 -05001618
Howard Hinnantcf823322010-12-17 14:46:43 +00001619 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00001620 void __erase_to_end(size_type __pos);
1621
Martijn Velsa81fc792020-02-26 13:25:43 -05001622 // __erase_external_with_move is invoked for erase() invocations where
1623 // `n ~= npos`, likely requiring memory moves on the string data.
1624 void __erase_external_with_move(size_type __pos, size_type __n);
1625
Howard Hinnantea8f7e12010-11-17 17:55:08 +00001626 _LIBCPP_INLINE_VISIBILITY
1627 void __copy_assign_alloc(const basic_string& __str)
1628 {__copy_assign_alloc(__str, integral_constant<bool,
1629 __alloc_traits::propagate_on_container_copy_assignment::value>());}
1630
1631 _LIBCPP_INLINE_VISIBILITY
1632 void __copy_assign_alloc(const basic_string& __str, true_type)
1633 {
Marshall Clowf258c202017-01-31 03:40:52 +00001634 if (__alloc() == __str.__alloc())
1635 __alloc() = __str.__alloc();
1636 else
Howard Hinnantea8f7e12010-11-17 17:55:08 +00001637 {
Marshall Clowf258c202017-01-31 03:40:52 +00001638 if (!__str.__is_long())
1639 {
Vedant Kumar55e007e2018-03-08 21:15:26 +00001640 __clear_and_shrink();
Marshall Clowf258c202017-01-31 03:40:52 +00001641 __alloc() = __str.__alloc();
1642 }
1643 else
1644 {
1645 allocator_type __a = __str.__alloc();
1646 pointer __p = __alloc_traits::allocate(__a, __str.__get_long_cap());
Vedant Kumar55e007e2018-03-08 21:15:26 +00001647 __clear_and_shrink();
Marshall Clowf258c202017-01-31 03:40:52 +00001648 __alloc() = _VSTD::move(__a);
1649 __set_long_pointer(__p);
1650 __set_long_cap(__str.__get_long_cap());
1651 __set_long_size(__str.size());
1652 }
Howard Hinnantea8f7e12010-11-17 17:55:08 +00001653 }
Howard Hinnantea8f7e12010-11-17 17:55:08 +00001654 }
1655
1656 _LIBCPP_INLINE_VISIBILITY
Howard Hinnant28b24882011-12-01 20:21:04 +00001657 void __copy_assign_alloc(const basic_string&, false_type) _NOEXCEPT
Howard Hinnantea8f7e12010-11-17 17:55:08 +00001658 {}
1659
Eric Fiselierfc92be82017-04-19 00:28:44 +00001660#ifndef _LIBCPP_CXX03_LANG
Howard Hinnantcf823322010-12-17 14:46:43 +00001661 _LIBCPP_INLINE_VISIBILITY
Marshall Clow2fe8a8d2015-08-18 18:57:00 +00001662 void __move_assign(basic_string& __str, false_type)
1663 _NOEXCEPT_(__alloc_traits::is_always_equal::value);
Howard Hinnantcf823322010-12-17 14:46:43 +00001664 _LIBCPP_INLINE_VISIBILITY
Howard Hinnant3e276872011-06-03 18:40:47 +00001665 void __move_assign(basic_string& __str, true_type)
Marshall Clow2fe8a8d2015-08-18 18:57:00 +00001666#if _LIBCPP_STD_VER > 14
1667 _NOEXCEPT;
1668#else
Howard Hinnant3e276872011-06-03 18:40:47 +00001669 _NOEXCEPT_(is_nothrow_move_assignable<allocator_type>::value);
Howard Hinnantea8f7e12010-11-17 17:55:08 +00001670#endif
Marshall Clow2fe8a8d2015-08-18 18:57:00 +00001671#endif
Howard Hinnantea8f7e12010-11-17 17:55:08 +00001672
1673 _LIBCPP_INLINE_VISIBILITY
Howard Hinnant58fe91b2011-08-17 20:36:18 +00001674 void
Howard Hinnantc2734962011-09-02 20:42:31 +00001675 __move_assign_alloc(basic_string& __str)
Howard Hinnant58fe91b2011-08-17 20:36:18 +00001676 _NOEXCEPT_(
1677 !__alloc_traits::propagate_on_container_move_assignment::value ||
1678 is_nothrow_move_assignable<allocator_type>::value)
1679 {__move_assign_alloc(__str, integral_constant<bool,
1680 __alloc_traits::propagate_on_container_move_assignment::value>());}
1681
1682 _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc2734962011-09-02 20:42:31 +00001683 void __move_assign_alloc(basic_string& __c, true_type)
Howard Hinnant58fe91b2011-08-17 20:36:18 +00001684 _NOEXCEPT_(is_nothrow_move_assignable<allocator_type>::value)
1685 {
1686 __alloc() = _VSTD::move(__c.__alloc());
1687 }
1688
1689 _LIBCPP_INLINE_VISIBILITY
Howard Hinnant28b24882011-12-01 20:21:04 +00001690 void __move_assign_alloc(basic_string&, false_type)
Howard Hinnant58fe91b2011-08-17 20:36:18 +00001691 _NOEXCEPT
1692 {}
1693
Martijn Velsda7d94f2020-06-19 14:24:03 -04001694 basic_string& __assign_external(const value_type* __s);
1695 basic_string& __assign_external(const value_type* __s, size_type __n);
1696
1697 // Assigns the value in __s, guaranteed to be __n < __min_cap in length.
1698 inline basic_string& __assign_short(const value_type* __s, size_type __n) {
1699 pointer __p = __is_long()
1700 ? (__set_long_size(__n), __get_long_pointer())
1701 : (__set_short_size(__n), __get_short_pointer());
1702 traits_type::move(_VSTD::__to_address(__p), __s, __n);
1703 traits_type::assign(__p[__n], value_type());
1704 return *this;
1705 }
1706
Howard Hinnantcf823322010-12-17 14:46:43 +00001707 _LIBCPP_INLINE_VISIBILITY void __invalidate_all_iterators();
1708 _LIBCPP_INLINE_VISIBILITY void __invalidate_iterators_past(size_type);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001709
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04001710 template<class _Tp>
1711 _LIBCPP_INLINE_VISIBILITY
1712 bool __addr_in_range(_Tp&& __t) const {
1713 const volatile void *__p = _VSTD::addressof(__t);
1714 return data() <= __p && __p <= data() + size();
1715 }
1716
Howard Hinnantc51e1022010-05-11 19:42:16 +00001717 friend basic_string operator+<>(const basic_string&, const basic_string&);
1718 friend basic_string operator+<>(const value_type*, const basic_string&);
1719 friend basic_string operator+<>(value_type, const basic_string&);
1720 friend basic_string operator+<>(const basic_string&, const value_type*);
1721 friend basic_string operator+<>(const basic_string&, value_type);
1722};
1723
Eric Fiselier2ed640b2020-03-04 13:54:04 -05001724// These declarations must appear before any functions are implicitly used
1725// so that they have the correct visibility specifier.
1726#ifdef _LIBCPP_ABI_STRING_OPTIMIZED_EXTERNAL_INSTANTIATION
1727_LIBCPP_STRING_UNSTABLE_EXTERN_TEMPLATE_LIST(_LIBCPP_EXTERN_TEMPLATE, char)
1728_LIBCPP_STRING_UNSTABLE_EXTERN_TEMPLATE_LIST(_LIBCPP_EXTERN_TEMPLATE, wchar_t)
1729#else
1730_LIBCPP_STRING_V1_EXTERN_TEMPLATE_LIST(_LIBCPP_EXTERN_TEMPLATE, char)
1731_LIBCPP_STRING_V1_EXTERN_TEMPLATE_LIST(_LIBCPP_EXTERN_TEMPLATE, wchar_t)
1732#endif
1733
1734
Marshall Clowa0563332018-02-08 06:34:03 +00001735#ifndef _LIBCPP_HAS_NO_DEDUCTION_GUIDES
1736template<class _InputIterator,
Arthur O'Dwyer56226762021-03-03 23:02:20 -05001737 class _CharT = __iter_value_type<_InputIterator>,
Marshall Clowa0563332018-02-08 06:34:03 +00001738 class _Allocator = allocator<_CharT>,
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001739 class = _EnableIf<__is_cpp17_input_iterator<_InputIterator>::value>,
1740 class = _EnableIf<__is_allocator<_Allocator>::value>
Marshall Clowa0563332018-02-08 06:34:03 +00001741 >
1742basic_string(_InputIterator, _InputIterator, _Allocator = _Allocator())
1743 -> basic_string<_CharT, char_traits<_CharT>, _Allocator>;
Marshall Clowe46031a2018-07-02 18:41:15 +00001744
1745template<class _CharT,
1746 class _Traits,
1747 class _Allocator = allocator<_CharT>,
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001748 class = _EnableIf<__is_allocator<_Allocator>::value>
Marshall Clowe46031a2018-07-02 18:41:15 +00001749 >
1750explicit basic_string(basic_string_view<_CharT, _Traits>, const _Allocator& = _Allocator())
1751 -> basic_string<_CharT, _Traits, _Allocator>;
1752
1753template<class _CharT,
1754 class _Traits,
1755 class _Allocator = allocator<_CharT>,
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001756 class = _EnableIf<__is_allocator<_Allocator>::value>,
Marshall Clowe46031a2018-07-02 18:41:15 +00001757 class _Sz = typename allocator_traits<_Allocator>::size_type
1758 >
1759basic_string(basic_string_view<_CharT, _Traits>, _Sz, _Sz, const _Allocator& = _Allocator())
1760 -> basic_string<_CharT, _Traits, _Allocator>;
Marshall Clowa0563332018-02-08 06:34:03 +00001761#endif
1762
Howard Hinnantc51e1022010-05-11 19:42:16 +00001763template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00001764inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00001765void
1766basic_string<_CharT, _Traits, _Allocator>::__invalidate_all_iterators()
1767{
Louis Dionneba400782020-10-02 15:02:52 -04001768#if _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnant8ea98242013-08-23 17:37:05 +00001769 __get_db()->__invalidate_all(this);
Louis Dionneba400782020-10-02 15:02:52 -04001770#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +00001771}
1772
1773template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00001774inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00001775void
Arthur O'Dwyerb3db4542021-04-27 09:10:04 -04001776basic_string<_CharT, _Traits, _Allocator>::__invalidate_iterators_past(size_type __pos)
Howard Hinnantc51e1022010-05-11 19:42:16 +00001777{
Louis Dionneba400782020-10-02 15:02:52 -04001778#if _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnant8ea98242013-08-23 17:37:05 +00001779 __c_node* __c = __get_db()->__find_c_and_lock(this);
1780 if (__c)
Howard Hinnantc51e1022010-05-11 19:42:16 +00001781 {
Howard Hinnant8ea98242013-08-23 17:37:05 +00001782 const_pointer __new_last = __get_pointer() + __pos;
1783 for (__i_node** __p = __c->end_; __p != __c->beg_; )
Howard Hinnantc51e1022010-05-11 19:42:16 +00001784 {
Howard Hinnant8ea98242013-08-23 17:37:05 +00001785 --__p;
1786 const_iterator* __i = static_cast<const_iterator*>((*__p)->__i_);
1787 if (__i->base() > __new_last)
Howard Hinnantc51e1022010-05-11 19:42:16 +00001788 {
Howard Hinnant8ea98242013-08-23 17:37:05 +00001789 (*__p)->__c_ = nullptr;
1790 if (--__c->end_ != __p)
Arthur O'Dwyer22236632020-12-07 21:50:15 -05001791 _VSTD::memmove(__p, __p+1, (__c->end_ - __p)*sizeof(__i_node*));
Howard Hinnantc51e1022010-05-11 19:42:16 +00001792 }
Howard Hinnantc51e1022010-05-11 19:42:16 +00001793 }
Howard Hinnant8ea98242013-08-23 17:37:05 +00001794 __get_db()->unlock();
Howard Hinnantc51e1022010-05-11 19:42:16 +00001795 }
Arthur O'Dwyerb3db4542021-04-27 09:10:04 -04001796#else
1797 (void)__pos;
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04001798#endif // _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnantc51e1022010-05-11 19:42:16 +00001799}
1800
1801template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00001802inline
Howard Hinnant3e276872011-06-03 18:40:47 +00001803basic_string<_CharT, _Traits, _Allocator>::basic_string()
Marshall Clowe546cbb2015-06-04 02:05:41 +00001804 _NOEXCEPT_(is_nothrow_default_constructible<allocator_type>::value)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05001805 : __r_(__default_init_tag(), __default_init_tag())
Howard Hinnantc51e1022010-05-11 19:42:16 +00001806{
Louis Dionneba400782020-10-02 15:02:52 -04001807#if _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnant8ea98242013-08-23 17:37:05 +00001808 __get_db()->__insert_c(this);
1809#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +00001810 __zero();
1811}
1812
1813template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00001814inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00001815basic_string<_CharT, _Traits, _Allocator>::basic_string(const allocator_type& __a)
Eric Fiseliere012bf22015-07-18 20:40:46 +00001816#if _LIBCPP_STD_VER <= 14
1817 _NOEXCEPT_(is_nothrow_copy_constructible<allocator_type>::value)
1818#else
1819 _NOEXCEPT
1820#endif
Eric Fiselier5169d1c2019-12-16 19:03:23 -05001821: __r_(__default_init_tag(), __a)
Howard Hinnantc51e1022010-05-11 19:42:16 +00001822{
Louis Dionneba400782020-10-02 15:02:52 -04001823#if _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnant8ea98242013-08-23 17:37:05 +00001824 __get_db()->__insert_c(this);
1825#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +00001826 __zero();
1827}
1828
1829template <class _CharT, class _Traits, class _Allocator>
Eric Fiselier815ed732016-09-16 00:00:48 +00001830void basic_string<_CharT, _Traits, _Allocator>::__init(const value_type* __s,
1831 size_type __sz,
1832 size_type __reserve)
Howard Hinnantc51e1022010-05-11 19:42:16 +00001833{
1834 if (__reserve > max_size())
1835 this->__throw_length_error();
1836 pointer __p;
1837 if (__reserve < __min_cap)
1838 {
1839 __set_short_size(__sz);
1840 __p = __get_short_pointer();
1841 }
1842 else
1843 {
1844 size_type __cap = __recommend(__reserve);
Howard Hinnantea8f7e12010-11-17 17:55:08 +00001845 __p = __alloc_traits::allocate(__alloc(), __cap+1);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001846 __set_long_pointer(__p);
1847 __set_long_cap(__cap+1);
1848 __set_long_size(__sz);
1849 }
Eric Fiselierc1b87a72019-11-16 17:13:26 -05001850 traits_type::copy(_VSTD::__to_address(__p), __s, __sz);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001851 traits_type::assign(__p[__sz], value_type());
1852}
1853
1854template <class _CharT, class _Traits, class _Allocator>
1855void
Howard Hinnantd17880b2013-06-28 16:59:19 +00001856basic_string<_CharT, _Traits, _Allocator>::__init(const value_type* __s, size_type __sz)
Howard Hinnantc51e1022010-05-11 19:42:16 +00001857{
1858 if (__sz > max_size())
1859 this->__throw_length_error();
1860 pointer __p;
1861 if (__sz < __min_cap)
1862 {
1863 __set_short_size(__sz);
1864 __p = __get_short_pointer();
1865 }
1866 else
1867 {
1868 size_type __cap = __recommend(__sz);
Howard Hinnantea8f7e12010-11-17 17:55:08 +00001869 __p = __alloc_traits::allocate(__alloc(), __cap+1);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001870 __set_long_pointer(__p);
1871 __set_long_cap(__cap+1);
1872 __set_long_size(__sz);
1873 }
Eric Fiselierc1b87a72019-11-16 17:13:26 -05001874 traits_type::copy(_VSTD::__to_address(__p), __s, __sz);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001875 traits_type::assign(__p[__sz], value_type());
1876}
1877
1878template <class _CharT, class _Traits, class _Allocator>
Marshall Clowe46031a2018-07-02 18:41:15 +00001879template <class>
Eric Fiselier812882b2017-02-17 01:17:10 +00001880basic_string<_CharT, _Traits, _Allocator>::basic_string(const _CharT* __s, const _Allocator& __a)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05001881 : __r_(__default_init_tag(), __a)
Howard Hinnantc51e1022010-05-11 19:42:16 +00001882{
Howard Hinnant8ea98242013-08-23 17:37:05 +00001883 _LIBCPP_ASSERT(__s != nullptr, "basic_string(const char*, allocator) detected nullptr");
Howard Hinnantc51e1022010-05-11 19:42:16 +00001884 __init(__s, traits_type::length(__s));
Louis Dionneba400782020-10-02 15:02:52 -04001885#if _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnant8ea98242013-08-23 17:37:05 +00001886 __get_db()->__insert_c(this);
1887#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +00001888}
1889
1890template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00001891inline
Eric Fiselier812882b2017-02-17 01:17:10 +00001892basic_string<_CharT, _Traits, _Allocator>::basic_string(const _CharT* __s, size_type __n)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05001893 : __r_(__default_init_tag(), __default_init_tag())
Howard Hinnantc51e1022010-05-11 19:42:16 +00001894{
Howard Hinnant8ea98242013-08-23 17:37:05 +00001895 _LIBCPP_ASSERT(__n == 0 || __s != nullptr, "basic_string(const char*, n) detected nullptr");
Howard Hinnantc51e1022010-05-11 19:42:16 +00001896 __init(__s, __n);
Louis Dionneba400782020-10-02 15:02:52 -04001897#if _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnant8ea98242013-08-23 17:37:05 +00001898 __get_db()->__insert_c(this);
1899#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +00001900}
1901
1902template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00001903inline
Eric Fiselier812882b2017-02-17 01:17:10 +00001904basic_string<_CharT, _Traits, _Allocator>::basic_string(const _CharT* __s, size_type __n, const _Allocator& __a)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05001905 : __r_(__default_init_tag(), __a)
Howard Hinnantc51e1022010-05-11 19:42:16 +00001906{
Howard Hinnant8ea98242013-08-23 17:37:05 +00001907 _LIBCPP_ASSERT(__n == 0 || __s != nullptr, "basic_string(const char*, n, allocator) detected nullptr");
Howard Hinnantc51e1022010-05-11 19:42:16 +00001908 __init(__s, __n);
Louis Dionneba400782020-10-02 15:02:52 -04001909#if _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnant8ea98242013-08-23 17:37:05 +00001910 __get_db()->__insert_c(this);
1911#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +00001912}
1913
1914template <class _CharT, class _Traits, class _Allocator>
1915basic_string<_CharT, _Traits, _Allocator>::basic_string(const basic_string& __str)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05001916 : __r_(__default_init_tag(), __alloc_traits::select_on_container_copy_construction(__str.__alloc()))
Howard Hinnantc51e1022010-05-11 19:42:16 +00001917{
1918 if (!__str.__is_long())
1919 __r_.first().__r = __str.__r_.first().__r;
1920 else
Martijn Vels5e7c9752020-03-04 17:52:46 -05001921 __init_copy_ctor_external(_VSTD::__to_address(__str.__get_long_pointer()),
1922 __str.__get_long_size());
1923
Louis Dionneba400782020-10-02 15:02:52 -04001924#if _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnant8ea98242013-08-23 17:37:05 +00001925 __get_db()->__insert_c(this);
1926#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +00001927}
1928
1929template <class _CharT, class _Traits, class _Allocator>
Eric Fiselier812882b2017-02-17 01:17:10 +00001930basic_string<_CharT, _Traits, _Allocator>::basic_string(
1931 const basic_string& __str, const allocator_type& __a)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05001932 : __r_(__default_init_tag(), __a)
Howard Hinnantc51e1022010-05-11 19:42:16 +00001933{
1934 if (!__str.__is_long())
1935 __r_.first().__r = __str.__r_.first().__r;
1936 else
Martijn Vels5e7c9752020-03-04 17:52:46 -05001937 __init_copy_ctor_external(_VSTD::__to_address(__str.__get_long_pointer()),
1938 __str.__get_long_size());
Louis Dionneba400782020-10-02 15:02:52 -04001939#if _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnant8ea98242013-08-23 17:37:05 +00001940 __get_db()->__insert_c(this);
1941#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +00001942}
1943
Martijn Vels5e7c9752020-03-04 17:52:46 -05001944template <class _CharT, class _Traits, class _Allocator>
1945void basic_string<_CharT, _Traits, _Allocator>::__init_copy_ctor_external(
1946 const value_type* __s, size_type __sz) {
1947 pointer __p;
1948 if (__sz < __min_cap) {
1949 __p = __get_short_pointer();
1950 __set_short_size(__sz);
1951 } else {
1952 if (__sz > max_size())
1953 this->__throw_length_error();
1954 size_t __cap = __recommend(__sz);
1955 __p = __alloc_traits::allocate(__alloc(), __cap + 1);
1956 __set_long_pointer(__p);
1957 __set_long_cap(__cap + 1);
1958 __set_long_size(__sz);
1959 }
1960 traits_type::copy(_VSTD::__to_address(__p), __s, __sz + 1);
1961}
1962
Eric Fiselierfc92be82017-04-19 00:28:44 +00001963#ifndef _LIBCPP_CXX03_LANG
Howard Hinnantc51e1022010-05-11 19:42:16 +00001964
1965template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00001966inline
Howard Hinnant3e276872011-06-03 18:40:47 +00001967basic_string<_CharT, _Traits, _Allocator>::basic_string(basic_string&& __str)
Marshall Clowa80abc72015-06-03 19:56:43 +00001968#if _LIBCPP_STD_VER <= 14
Howard Hinnant3e276872011-06-03 18:40:47 +00001969 _NOEXCEPT_(is_nothrow_move_constructible<allocator_type>::value)
Marshall Clowa80abc72015-06-03 19:56:43 +00001970#else
1971 _NOEXCEPT
1972#endif
Howard Hinnantb1ad5a82011-06-30 21:18:19 +00001973 : __r_(_VSTD::move(__str.__r_))
Howard Hinnantc51e1022010-05-11 19:42:16 +00001974{
1975 __str.__zero();
Louis Dionneba400782020-10-02 15:02:52 -04001976#if _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnant8ea98242013-08-23 17:37:05 +00001977 __get_db()->__insert_c(this);
1978 if (__is_long())
1979 __get_db()->swap(this, &__str);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001980#endif
1981}
1982
1983template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00001984inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00001985basic_string<_CharT, _Traits, _Allocator>::basic_string(basic_string&& __str, const allocator_type& __a)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05001986 : __r_(__default_init_tag(), __a)
Howard Hinnantc51e1022010-05-11 19:42:16 +00001987{
Marshall Clowd2d24692014-07-17 15:32:20 +00001988 if (__str.__is_long() && __a != __str.__alloc()) // copy, not move
Eric Fiselierc1b87a72019-11-16 17:13:26 -05001989 __init(_VSTD::__to_address(__str.__get_long_pointer()), __str.__get_long_size());
Marshall Clowd2d24692014-07-17 15:32:20 +00001990 else
1991 {
1992 __r_.first().__r = __str.__r_.first().__r;
1993 __str.__zero();
1994 }
Louis Dionneba400782020-10-02 15:02:52 -04001995#if _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnant8ea98242013-08-23 17:37:05 +00001996 __get_db()->__insert_c(this);
1997 if (__is_long())
1998 __get_db()->swap(this, &__str);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001999#endif
2000}
2001
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04002002#endif // _LIBCPP_CXX03_LANG
Howard Hinnantc51e1022010-05-11 19:42:16 +00002003
2004template <class _CharT, class _Traits, class _Allocator>
2005void
2006basic_string<_CharT, _Traits, _Allocator>::__init(size_type __n, value_type __c)
2007{
2008 if (__n > max_size())
2009 this->__throw_length_error();
2010 pointer __p;
2011 if (__n < __min_cap)
2012 {
2013 __set_short_size(__n);
2014 __p = __get_short_pointer();
2015 }
2016 else
2017 {
2018 size_type __cap = __recommend(__n);
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002019 __p = __alloc_traits::allocate(__alloc(), __cap+1);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002020 __set_long_pointer(__p);
2021 __set_long_cap(__cap+1);
2022 __set_long_size(__n);
2023 }
Eric Fiselierc1b87a72019-11-16 17:13:26 -05002024 traits_type::assign(_VSTD::__to_address(__p), __n, __c);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002025 traits_type::assign(__p[__n], value_type());
2026}
2027
2028template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00002029inline
Eric Fiselier812882b2017-02-17 01:17:10 +00002030basic_string<_CharT, _Traits, _Allocator>::basic_string(size_type __n, _CharT __c)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05002031 : __r_(__default_init_tag(), __default_init_tag())
Howard Hinnantc51e1022010-05-11 19:42:16 +00002032{
2033 __init(__n, __c);
Louis Dionneba400782020-10-02 15:02:52 -04002034#if _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnant8ea98242013-08-23 17:37:05 +00002035 __get_db()->__insert_c(this);
2036#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +00002037}
2038
2039template <class _CharT, class _Traits, class _Allocator>
Marshall Clowe46031a2018-07-02 18:41:15 +00002040template <class>
Eric Fiselier812882b2017-02-17 01:17:10 +00002041basic_string<_CharT, _Traits, _Allocator>::basic_string(size_type __n, _CharT __c, const _Allocator& __a)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05002042 : __r_(__default_init_tag(), __a)
Howard Hinnantc51e1022010-05-11 19:42:16 +00002043{
2044 __init(__n, __c);
Louis Dionneba400782020-10-02 15:02:52 -04002045#if _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnant8ea98242013-08-23 17:37:05 +00002046 __get_db()->__insert_c(this);
2047#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +00002048}
2049
Howard Hinnantc51e1022010-05-11 19:42:16 +00002050template <class _CharT, class _Traits, class _Allocator>
Eric Fiselier812882b2017-02-17 01:17:10 +00002051basic_string<_CharT, _Traits, _Allocator>::basic_string(const basic_string& __str,
2052 size_type __pos, size_type __n,
2053 const _Allocator& __a)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05002054 : __r_(__default_init_tag(), __a)
Howard Hinnantc51e1022010-05-11 19:42:16 +00002055{
2056 size_type __str_sz = __str.size();
2057 if (__pos > __str_sz)
2058 this->__throw_out_of_range();
Howard Hinnantb1ad5a82011-06-30 21:18:19 +00002059 __init(__str.data() + __pos, _VSTD::min(__n, __str_sz - __pos));
Louis Dionneba400782020-10-02 15:02:52 -04002060#if _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnant8ea98242013-08-23 17:37:05 +00002061 __get_db()->__insert_c(this);
2062#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +00002063}
2064
2065template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00002066inline
Marshall Clow83445802016-04-07 18:13:41 +00002067basic_string<_CharT, _Traits, _Allocator>::basic_string(const basic_string& __str, size_type __pos,
Eric Fiselier812882b2017-02-17 01:17:10 +00002068 const _Allocator& __a)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05002069 : __r_(__default_init_tag(), __a)
Marshall Clow83445802016-04-07 18:13:41 +00002070{
2071 size_type __str_sz = __str.size();
2072 if (__pos > __str_sz)
2073 this->__throw_out_of_range();
2074 __init(__str.data() + __pos, __str_sz - __pos);
Louis Dionneba400782020-10-02 15:02:52 -04002075#if _LIBCPP_DEBUG_LEVEL == 2
Marshall Clow83445802016-04-07 18:13:41 +00002076 __get_db()->__insert_c(this);
2077#endif
2078}
2079
2080template <class _CharT, class _Traits, class _Allocator>
Marshall Clowe46031a2018-07-02 18:41:15 +00002081template <class _Tp, class>
Marshall Clow78dbe462016-11-14 18:22:19 +00002082basic_string<_CharT, _Traits, _Allocator>::basic_string(
Marshall Clowe46031a2018-07-02 18:41:15 +00002083 const _Tp& __t, size_type __pos, size_type __n, const allocator_type& __a)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05002084 : __r_(__default_init_tag(), __a)
Marshall Clow78dbe462016-11-14 18:22:19 +00002085{
Marshall Clowe46031a2018-07-02 18:41:15 +00002086 __self_view __sv0 = __t;
2087 __self_view __sv = __sv0.substr(__pos, __n);
Marshall Clow78dbe462016-11-14 18:22:19 +00002088 __init(__sv.data(), __sv.size());
Louis Dionneba400782020-10-02 15:02:52 -04002089#if _LIBCPP_DEBUG_LEVEL == 2
Marshall Clow78dbe462016-11-14 18:22:19 +00002090 __get_db()->__insert_c(this);
Eric Fiselier812882b2017-02-17 01:17:10 +00002091#endif
Marshall Clow78dbe462016-11-14 18:22:19 +00002092}
2093
2094template <class _CharT, class _Traits, class _Allocator>
Marshall Clowe46031a2018-07-02 18:41:15 +00002095template <class _Tp, class>
2096basic_string<_CharT, _Traits, _Allocator>::basic_string(const _Tp & __t)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05002097 : __r_(__default_init_tag(), __default_init_tag())
Marshall Clowdf63a6d2016-07-21 05:31:24 +00002098{
Marshall Clowe46031a2018-07-02 18:41:15 +00002099 __self_view __sv = __t;
Marshall Clowdf63a6d2016-07-21 05:31:24 +00002100 __init(__sv.data(), __sv.size());
Louis Dionneba400782020-10-02 15:02:52 -04002101#if _LIBCPP_DEBUG_LEVEL == 2
Marshall Clowdf63a6d2016-07-21 05:31:24 +00002102 __get_db()->__insert_c(this);
2103#endif
2104}
2105
2106template <class _CharT, class _Traits, class _Allocator>
Marshall Clowe46031a2018-07-02 18:41:15 +00002107template <class _Tp, class>
2108basic_string<_CharT, _Traits, _Allocator>::basic_string(const _Tp & __t, const _Allocator& __a)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05002109 : __r_(__default_init_tag(), __a)
Marshall Clowdf63a6d2016-07-21 05:31:24 +00002110{
Marshall Clowe46031a2018-07-02 18:41:15 +00002111 __self_view __sv = __t;
Marshall Clowdf63a6d2016-07-21 05:31:24 +00002112 __init(__sv.data(), __sv.size());
Louis Dionneba400782020-10-02 15:02:52 -04002113#if _LIBCPP_DEBUG_LEVEL == 2
Marshall Clowdf63a6d2016-07-21 05:31:24 +00002114 __get_db()->__insert_c(this);
2115#endif
2116}
2117
2118template <class _CharT, class _Traits, class _Allocator>
Howard Hinnantc51e1022010-05-11 19:42:16 +00002119template <class _InputIterator>
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002120_EnableIf
Howard Hinnantc51e1022010-05-11 19:42:16 +00002121<
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002122 __is_exactly_cpp17_input_iterator<_InputIterator>::value
2123>
Howard Hinnantc51e1022010-05-11 19:42:16 +00002124basic_string<_CharT, _Traits, _Allocator>::__init(_InputIterator __first, _InputIterator __last)
2125{
2126 __zero();
2127#ifndef _LIBCPP_NO_EXCEPTIONS
2128 try
2129 {
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04002130#endif // _LIBCPP_NO_EXCEPTIONS
Howard Hinnantc51e1022010-05-11 19:42:16 +00002131 for (; __first != __last; ++__first)
2132 push_back(*__first);
2133#ifndef _LIBCPP_NO_EXCEPTIONS
2134 }
2135 catch (...)
2136 {
2137 if (__is_long())
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002138 __alloc_traits::deallocate(__alloc(), __get_long_pointer(), __get_long_cap());
Howard Hinnantc51e1022010-05-11 19:42:16 +00002139 throw;
2140 }
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04002141#endif // _LIBCPP_NO_EXCEPTIONS
Howard Hinnantc51e1022010-05-11 19:42:16 +00002142}
2143
2144template <class _CharT, class _Traits, class _Allocator>
2145template <class _ForwardIterator>
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002146_EnableIf
Howard Hinnantc51e1022010-05-11 19:42:16 +00002147<
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002148 __is_cpp17_forward_iterator<_ForwardIterator>::value
2149>
Howard Hinnantc51e1022010-05-11 19:42:16 +00002150basic_string<_CharT, _Traits, _Allocator>::__init(_ForwardIterator __first, _ForwardIterator __last)
2151{
Howard Hinnantb1ad5a82011-06-30 21:18:19 +00002152 size_type __sz = static_cast<size_type>(_VSTD::distance(__first, __last));
Howard Hinnantc51e1022010-05-11 19:42:16 +00002153 if (__sz > max_size())
2154 this->__throw_length_error();
2155 pointer __p;
2156 if (__sz < __min_cap)
2157 {
2158 __set_short_size(__sz);
2159 __p = __get_short_pointer();
2160 }
2161 else
2162 {
2163 size_type __cap = __recommend(__sz);
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002164 __p = __alloc_traits::allocate(__alloc(), __cap+1);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002165 __set_long_pointer(__p);
2166 __set_long_cap(__cap+1);
2167 __set_long_size(__sz);
2168 }
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04002169
2170#ifndef _LIBCPP_NO_EXCEPTIONS
2171 try
2172 {
2173#endif // _LIBCPP_NO_EXCEPTIONS
Eric Fiseliera09a3b42014-10-27 19:28:20 +00002174 for (; __first != __last; ++__first, (void) ++__p)
Howard Hinnantc51e1022010-05-11 19:42:16 +00002175 traits_type::assign(*__p, *__first);
2176 traits_type::assign(*__p, value_type());
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04002177#ifndef _LIBCPP_NO_EXCEPTIONS
2178 }
2179 catch (...)
2180 {
2181 if (__is_long())
2182 __alloc_traits::deallocate(__alloc(), __get_long_pointer(), __get_long_cap());
2183 throw;
2184 }
2185#endif // _LIBCPP_NO_EXCEPTIONS
Howard Hinnantc51e1022010-05-11 19:42:16 +00002186}
2187
2188template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierc0f566d2019-03-14 12:31:10 +00002189template<class _InputIterator, class>
Eric Fiselierbea70602018-11-26 22:51:35 +00002190inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00002191basic_string<_CharT, _Traits, _Allocator>::basic_string(_InputIterator __first, _InputIterator __last)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05002192 : __r_(__default_init_tag(), __default_init_tag())
Howard Hinnantc51e1022010-05-11 19:42:16 +00002193{
2194 __init(__first, __last);
Louis Dionneba400782020-10-02 15:02:52 -04002195#if _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnant8ea98242013-08-23 17:37:05 +00002196 __get_db()->__insert_c(this);
2197#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +00002198}
2199
2200template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierc0f566d2019-03-14 12:31:10 +00002201template<class _InputIterator, class>
Eric Fiselierbea70602018-11-26 22:51:35 +00002202inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00002203basic_string<_CharT, _Traits, _Allocator>::basic_string(_InputIterator __first, _InputIterator __last,
2204 const allocator_type& __a)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05002205 : __r_(__default_init_tag(), __a)
Howard Hinnantc51e1022010-05-11 19:42:16 +00002206{
2207 __init(__first, __last);
Louis Dionneba400782020-10-02 15:02:52 -04002208#if _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnant8ea98242013-08-23 17:37:05 +00002209 __get_db()->__insert_c(this);
2210#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +00002211}
2212
Eric Fiselierfc92be82017-04-19 00:28:44 +00002213#ifndef _LIBCPP_CXX03_LANG
Howard Hinnant33711792011-08-12 21:56:02 +00002214
Howard Hinnantc51e1022010-05-11 19:42:16 +00002215template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00002216inline
Eric Fiselier812882b2017-02-17 01:17:10 +00002217basic_string<_CharT, _Traits, _Allocator>::basic_string(
2218 initializer_list<_CharT> __il)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05002219 : __r_(__default_init_tag(), __default_init_tag())
Howard Hinnantc51e1022010-05-11 19:42:16 +00002220{
2221 __init(__il.begin(), __il.end());
Louis Dionneba400782020-10-02 15:02:52 -04002222#if _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnant8ea98242013-08-23 17:37:05 +00002223 __get_db()->__insert_c(this);
2224#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +00002225}
2226
2227template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00002228inline
Eric Fiselier9d355982017-04-12 23:45:53 +00002229
Eric Fiselier812882b2017-02-17 01:17:10 +00002230basic_string<_CharT, _Traits, _Allocator>::basic_string(
2231 initializer_list<_CharT> __il, const _Allocator& __a)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05002232 : __r_(__default_init_tag(), __a)
Howard Hinnantc51e1022010-05-11 19:42:16 +00002233{
2234 __init(__il.begin(), __il.end());
Louis Dionneba400782020-10-02 15:02:52 -04002235#if _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnant8ea98242013-08-23 17:37:05 +00002236 __get_db()->__insert_c(this);
2237#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +00002238}
2239
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04002240#endif // _LIBCPP_CXX03_LANG
Howard Hinnant33711792011-08-12 21:56:02 +00002241
Howard Hinnantc51e1022010-05-11 19:42:16 +00002242template <class _CharT, class _Traits, class _Allocator>
Howard Hinnantc51e1022010-05-11 19:42:16 +00002243basic_string<_CharT, _Traits, _Allocator>::~basic_string()
2244{
Louis Dionneba400782020-10-02 15:02:52 -04002245#if _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnant8ea98242013-08-23 17:37:05 +00002246 __get_db()->__erase_c(this);
2247#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +00002248 if (__is_long())
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002249 __alloc_traits::deallocate(__alloc(), __get_long_pointer(), __get_long_cap());
Howard Hinnantc51e1022010-05-11 19:42:16 +00002250}
2251
2252template <class _CharT, class _Traits, class _Allocator>
2253void
2254basic_string<_CharT, _Traits, _Allocator>::__grow_by_and_replace
2255 (size_type __old_cap, size_type __delta_cap, size_type __old_sz,
Howard Hinnantd17880b2013-06-28 16:59:19 +00002256 size_type __n_copy, size_type __n_del, size_type __n_add, const value_type* __p_new_stuff)
Howard Hinnantc51e1022010-05-11 19:42:16 +00002257{
2258 size_type __ms = max_size();
2259 if (__delta_cap > __ms - __old_cap - 1)
2260 this->__throw_length_error();
2261 pointer __old_p = __get_pointer();
2262 size_type __cap = __old_cap < __ms / 2 - __alignment ?
Howard Hinnantb1ad5a82011-06-30 21:18:19 +00002263 __recommend(_VSTD::max(__old_cap + __delta_cap, 2 * __old_cap)) :
Howard Hinnantc51e1022010-05-11 19:42:16 +00002264 __ms - 1;
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002265 pointer __p = __alloc_traits::allocate(__alloc(), __cap+1);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002266 __invalidate_all_iterators();
2267 if (__n_copy != 0)
Eric Fiselierc1b87a72019-11-16 17:13:26 -05002268 traits_type::copy(_VSTD::__to_address(__p),
2269 _VSTD::__to_address(__old_p), __n_copy);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002270 if (__n_add != 0)
Eric Fiselierc1b87a72019-11-16 17:13:26 -05002271 traits_type::copy(_VSTD::__to_address(__p) + __n_copy, __p_new_stuff, __n_add);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002272 size_type __sec_cp_sz = __old_sz - __n_del - __n_copy;
2273 if (__sec_cp_sz != 0)
Eric Fiselierc1b87a72019-11-16 17:13:26 -05002274 traits_type::copy(_VSTD::__to_address(__p) + __n_copy + __n_add,
2275 _VSTD::__to_address(__old_p) + __n_copy + __n_del, __sec_cp_sz);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002276 if (__old_cap+1 != __min_cap)
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002277 __alloc_traits::deallocate(__alloc(), __old_p, __old_cap+1);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002278 __set_long_pointer(__p);
2279 __set_long_cap(__cap+1);
2280 __old_sz = __n_copy + __n_add + __sec_cp_sz;
2281 __set_long_size(__old_sz);
2282 traits_type::assign(__p[__old_sz], value_type());
2283}
2284
2285template <class _CharT, class _Traits, class _Allocator>
2286void
2287basic_string<_CharT, _Traits, _Allocator>::__grow_by(size_type __old_cap, size_type __delta_cap, size_type __old_sz,
2288 size_type __n_copy, size_type __n_del, size_type __n_add)
2289{
2290 size_type __ms = max_size();
Marshall Clow2267c5d2013-11-06 14:24:38 +00002291 if (__delta_cap > __ms - __old_cap)
Howard Hinnantc51e1022010-05-11 19:42:16 +00002292 this->__throw_length_error();
2293 pointer __old_p = __get_pointer();
2294 size_type __cap = __old_cap < __ms / 2 - __alignment ?
Howard Hinnantb1ad5a82011-06-30 21:18:19 +00002295 __recommend(_VSTD::max(__old_cap + __delta_cap, 2 * __old_cap)) :
Howard Hinnantc51e1022010-05-11 19:42:16 +00002296 __ms - 1;
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002297 pointer __p = __alloc_traits::allocate(__alloc(), __cap+1);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002298 __invalidate_all_iterators();
2299 if (__n_copy != 0)
Eric Fiselierc1b87a72019-11-16 17:13:26 -05002300 traits_type::copy(_VSTD::__to_address(__p),
2301 _VSTD::__to_address(__old_p), __n_copy);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002302 size_type __sec_cp_sz = __old_sz - __n_del - __n_copy;
2303 if (__sec_cp_sz != 0)
Eric Fiselierc1b87a72019-11-16 17:13:26 -05002304 traits_type::copy(_VSTD::__to_address(__p) + __n_copy + __n_add,
2305 _VSTD::__to_address(__old_p) + __n_copy + __n_del,
Howard Hinnantd17880b2013-06-28 16:59:19 +00002306 __sec_cp_sz);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002307 if (__old_cap+1 != __min_cap)
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002308 __alloc_traits::deallocate(__alloc(), __old_p, __old_cap+1);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002309 __set_long_pointer(__p);
2310 __set_long_cap(__cap+1);
2311}
2312
2313// assign
2314
2315template <class _CharT, class _Traits, class _Allocator>
Martijn Vels596e3de2020-02-26 15:55:49 -05002316template <bool __is_short>
Martijn Velsb6a08b62020-04-10 18:36:31 -04002317basic_string<_CharT, _Traits, _Allocator>&
2318basic_string<_CharT, _Traits, _Allocator>::__assign_no_alias(
Martijn Vels596e3de2020-02-26 15:55:49 -05002319 const value_type* __s, size_type __n) {
2320 size_type __cap = __is_short ? __min_cap : __get_long_cap();
2321 if (__n < __cap) {
2322 pointer __p = __is_short ? __get_short_pointer() : __get_long_pointer();
2323 __is_short ? __set_short_size(__n) : __set_long_size(__n);
2324 traits_type::copy(_VSTD::__to_address(__p), __s, __n);
2325 traits_type::assign(__p[__n], value_type());
2326 __invalidate_iterators_past(__n);
2327 } else {
2328 size_type __sz = __is_short ? __get_short_size() : __get_long_size();
2329 __grow_by_and_replace(__cap - 1, __n - __cap + 1, __sz, 0, __sz, __n, __s);
2330 }
Martijn Velsb6a08b62020-04-10 18:36:31 -04002331 return *this;
Martijn Vels596e3de2020-02-26 15:55:49 -05002332}
2333
2334template <class _CharT, class _Traits, class _Allocator>
Howard Hinnantc51e1022010-05-11 19:42:16 +00002335basic_string<_CharT, _Traits, _Allocator>&
Martijn Velsda7d94f2020-06-19 14:24:03 -04002336basic_string<_CharT, _Traits, _Allocator>::__assign_external(
2337 const value_type* __s, size_type __n) {
2338 size_type __cap = capacity();
2339 if (__cap >= __n) {
2340 value_type* __p = _VSTD::__to_address(__get_pointer());
2341 traits_type::move(__p, __s, __n);
2342 traits_type::assign(__p[__n], value_type());
2343 __set_size(__n);
2344 __invalidate_iterators_past(__n);
2345 } else {
2346 size_type __sz = size();
2347 __grow_by_and_replace(__cap, __n - __cap, __sz, 0, __sz, __n, __s);
2348 }
2349 return *this;
2350}
2351
2352template <class _CharT, class _Traits, class _Allocator>
2353basic_string<_CharT, _Traits, _Allocator>&
Howard Hinnantd17880b2013-06-28 16:59:19 +00002354basic_string<_CharT, _Traits, _Allocator>::assign(const value_type* __s, size_type __n)
Howard Hinnantc51e1022010-05-11 19:42:16 +00002355{
Alp Tokerb8a95f52014-05-15 11:27:39 +00002356 _LIBCPP_ASSERT(__n == 0 || __s != nullptr, "string::assign received nullptr");
Martijn Velsda7d94f2020-06-19 14:24:03 -04002357 return (_LIBCPP_BUILTIN_CONSTANT_P(__n) && __n < __min_cap)
2358 ? __assign_short(__s, __n)
2359 : __assign_external(__s, __n);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002360}
2361
2362template <class _CharT, class _Traits, class _Allocator>
2363basic_string<_CharT, _Traits, _Allocator>&
2364basic_string<_CharT, _Traits, _Allocator>::assign(size_type __n, value_type __c)
2365{
2366 size_type __cap = capacity();
2367 if (__cap < __n)
2368 {
2369 size_type __sz = size();
2370 __grow_by(__cap, __n - __cap, __sz, 0, __sz);
2371 }
Eric Fiselierc1b87a72019-11-16 17:13:26 -05002372 value_type* __p = _VSTD::__to_address(__get_pointer());
Howard Hinnantc51e1022010-05-11 19:42:16 +00002373 traits_type::assign(__p, __n, __c);
2374 traits_type::assign(__p[__n], value_type());
2375 __set_size(__n);
Arthur O'Dwyerb3db4542021-04-27 09:10:04 -04002376 __invalidate_iterators_past(__n);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002377 return *this;
2378}
2379
2380template <class _CharT, class _Traits, class _Allocator>
2381basic_string<_CharT, _Traits, _Allocator>&
2382basic_string<_CharT, _Traits, _Allocator>::operator=(value_type __c)
2383{
2384 pointer __p;
2385 if (__is_long())
2386 {
2387 __p = __get_long_pointer();
2388 __set_long_size(1);
2389 }
2390 else
2391 {
2392 __p = __get_short_pointer();
2393 __set_short_size(1);
2394 }
2395 traits_type::assign(*__p, __c);
2396 traits_type::assign(*++__p, value_type());
2397 __invalidate_iterators_past(1);
2398 return *this;
2399}
2400
2401template <class _CharT, class _Traits, class _Allocator>
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002402basic_string<_CharT, _Traits, _Allocator>&
2403basic_string<_CharT, _Traits, _Allocator>::operator=(const basic_string& __str)
2404{
Martijn Vels596e3de2020-02-26 15:55:49 -05002405 if (this != &__str) {
2406 __copy_assign_alloc(__str);
2407 if (!__is_long()) {
2408 if (!__str.__is_long()) {
Eric Fiselier03bbc922020-01-15 17:27:10 -05002409 __r_.first().__r = __str.__r_.first().__r;
Martijn Vels596e3de2020-02-26 15:55:49 -05002410 } else {
Martijn Velsb6a08b62020-04-10 18:36:31 -04002411 return __assign_no_alias<true>(__str.data(), __str.size());
Martijn Vels596e3de2020-02-26 15:55:49 -05002412 }
2413 } else {
Martijn Velsb6a08b62020-04-10 18:36:31 -04002414 return __assign_no_alias<false>(__str.data(), __str.size());
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002415 }
Martijn Vels596e3de2020-02-26 15:55:49 -05002416 }
2417 return *this;
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002418}
2419
Eric Fiselierfc92be82017-04-19 00:28:44 +00002420#ifndef _LIBCPP_CXX03_LANG
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002421
2422template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00002423inline
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002424void
2425basic_string<_CharT, _Traits, _Allocator>::__move_assign(basic_string& __str, false_type)
Marshall Clow2fe8a8d2015-08-18 18:57:00 +00002426 _NOEXCEPT_(__alloc_traits::is_always_equal::value)
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002427{
2428 if (__alloc() != __str.__alloc())
2429 assign(__str);
2430 else
2431 __move_assign(__str, true_type());
2432}
2433
2434template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00002435inline
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002436void
2437basic_string<_CharT, _Traits, _Allocator>::__move_assign(basic_string& __str, true_type)
Marshall Clow2fe8a8d2015-08-18 18:57:00 +00002438#if _LIBCPP_STD_VER > 14
2439 _NOEXCEPT
2440#else
Howard Hinnant3e276872011-06-03 18:40:47 +00002441 _NOEXCEPT_(is_nothrow_move_assignable<allocator_type>::value)
Marshall Clow2fe8a8d2015-08-18 18:57:00 +00002442#endif
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002443{
marshall2ed41622019-11-27 07:13:00 -08002444 if (__is_long()) {
2445 __alloc_traits::deallocate(__alloc(), __get_long_pointer(),
2446 __get_long_cap());
2447#if _LIBCPP_STD_VER <= 14
2448 if (!is_nothrow_move_assignable<allocator_type>::value) {
2449 __set_short_size(0);
2450 traits_type::assign(__get_short_pointer()[0], value_type());
2451 }
2452#endif
2453 }
2454 __move_assign_alloc(__str);
2455 __r_.first() = __str.__r_.first();
2456 __str.__set_short_size(0);
2457 traits_type::assign(__str.__get_short_pointer()[0], value_type());
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002458}
2459
2460template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00002461inline
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002462basic_string<_CharT, _Traits, _Allocator>&
2463basic_string<_CharT, _Traits, _Allocator>::operator=(basic_string&& __str)
Marshall Clow2fe8a8d2015-08-18 18:57:00 +00002464 _NOEXCEPT_((__noexcept_move_assign_container<_Allocator, __alloc_traits>::value))
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002465{
2466 __move_assign(__str, integral_constant<bool,
2467 __alloc_traits::propagate_on_container_move_assignment::value>());
2468 return *this;
2469}
2470
2471#endif
2472
2473template <class _CharT, class _Traits, class _Allocator>
Howard Hinnantc51e1022010-05-11 19:42:16 +00002474template<class _InputIterator>
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002475_EnableIf
Howard Hinnantc51e1022010-05-11 19:42:16 +00002476<
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04002477 __is_exactly_cpp17_input_iterator<_InputIterator>::value,
Howard Hinnantc51e1022010-05-11 19:42:16 +00002478 basic_string<_CharT, _Traits, _Allocator>&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002479>
Howard Hinnantc51e1022010-05-11 19:42:16 +00002480basic_string<_CharT, _Traits, _Allocator>::assign(_InputIterator __first, _InputIterator __last)
2481{
Marshall Clow958362f2016-09-05 01:54:30 +00002482 const basic_string __temp(__first, __last, __alloc());
Marshall Clow039b2f02016-01-13 21:54:34 +00002483 assign(__temp.data(), __temp.size());
Argyrios Kyrtzidisaf904652012-10-13 02:03:45 +00002484 return *this;
Howard Hinnantc51e1022010-05-11 19:42:16 +00002485}
2486
2487template <class _CharT, class _Traits, class _Allocator>
2488template<class _ForwardIterator>
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002489_EnableIf
Howard Hinnantc51e1022010-05-11 19:42:16 +00002490<
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04002491 __is_cpp17_forward_iterator<_ForwardIterator>::value,
Howard Hinnantc51e1022010-05-11 19:42:16 +00002492 basic_string<_CharT, _Traits, _Allocator>&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002493>
Howard Hinnantc51e1022010-05-11 19:42:16 +00002494basic_string<_CharT, _Traits, _Allocator>::assign(_ForwardIterator __first, _ForwardIterator __last)
2495{
Howard Hinnantc51e1022010-05-11 19:42:16 +00002496 size_type __cap = capacity();
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04002497 size_type __n = __string_is_trivial_iterator<_ForwardIterator>::value ?
2498 static_cast<size_type>(_VSTD::distance(__first, __last)) : 0;
2499
2500 if (__string_is_trivial_iterator<_ForwardIterator>::value &&
2501 (__cap >= __n || !__addr_in_range(*__first)))
Howard Hinnantc51e1022010-05-11 19:42:16 +00002502 {
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04002503 if (__cap < __n)
2504 {
2505 size_type __sz = size();
2506 __grow_by(__cap, __n - __cap, __sz, 0, __sz);
2507 }
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04002508 pointer __p = __get_pointer();
2509 for (; __first != __last; ++__first, ++__p)
2510 traits_type::assign(*__p, *__first);
2511 traits_type::assign(*__p, value_type());
2512 __set_size(__n);
Arthur O'Dwyerb3db4542021-04-27 09:10:04 -04002513 __invalidate_iterators_past(__n);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002514 }
2515 else
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04002516 {
2517 const basic_string __temp(__first, __last, __alloc());
2518 assign(__temp.data(), __temp.size());
2519 }
Howard Hinnantc51e1022010-05-11 19:42:16 +00002520 return *this;
2521}
2522
2523template <class _CharT, class _Traits, class _Allocator>
Howard Hinnantc51e1022010-05-11 19:42:16 +00002524basic_string<_CharT, _Traits, _Allocator>&
2525basic_string<_CharT, _Traits, _Allocator>::assign(const basic_string& __str, size_type __pos, size_type __n)
2526{
2527 size_type __sz = __str.size();
2528 if (__pos > __sz)
2529 this->__throw_out_of_range();
Howard Hinnantb1ad5a82011-06-30 21:18:19 +00002530 return assign(__str.data() + __pos, _VSTD::min(__n, __sz - __pos));
Howard Hinnantc51e1022010-05-11 19:42:16 +00002531}
2532
2533template <class _CharT, class _Traits, class _Allocator>
Marshall Clow82513342016-09-24 22:45:42 +00002534template <class _Tp>
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002535_EnableIf
Marshall Clow82513342016-09-24 22:45:42 +00002536<
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002537 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value
2538 && !__is_same_uncvref<_Tp, basic_string<_CharT, _Traits, _Allocator> >::value,
Marshall Clowb7db4972017-11-15 20:02:27 +00002539 basic_string<_CharT, _Traits, _Allocator>&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002540>
Marshall Clow82513342016-09-24 22:45:42 +00002541basic_string<_CharT, _Traits, _Allocator>::assign(const _Tp & __t, size_type __pos, size_type __n)
Marshall Clowdf63a6d2016-07-21 05:31:24 +00002542{
Marshall Clow82513342016-09-24 22:45:42 +00002543 __self_view __sv = __t;
Marshall Clowdf63a6d2016-07-21 05:31:24 +00002544 size_type __sz = __sv.size();
2545 if (__pos > __sz)
2546 this->__throw_out_of_range();
2547 return assign(__sv.data() + __pos, _VSTD::min(__n, __sz - __pos));
2548}
2549
2550
2551template <class _CharT, class _Traits, class _Allocator>
Howard Hinnantc51e1022010-05-11 19:42:16 +00002552basic_string<_CharT, _Traits, _Allocator>&
Martijn Velsda7d94f2020-06-19 14:24:03 -04002553basic_string<_CharT, _Traits, _Allocator>::__assign_external(const value_type* __s) {
2554 return __assign_external(__s, traits_type::length(__s));
2555}
2556
2557template <class _CharT, class _Traits, class _Allocator>
2558basic_string<_CharT, _Traits, _Allocator>&
Howard Hinnantd17880b2013-06-28 16:59:19 +00002559basic_string<_CharT, _Traits, _Allocator>::assign(const value_type* __s)
Howard Hinnantc51e1022010-05-11 19:42:16 +00002560{
Alp Tokerb8a95f52014-05-15 11:27:39 +00002561 _LIBCPP_ASSERT(__s != nullptr, "string::assign received nullptr");
Martijn Velsda7d94f2020-06-19 14:24:03 -04002562 return _LIBCPP_BUILTIN_CONSTANT_P(*__s)
2563 ? (traits_type::length(__s) < __min_cap
2564 ? __assign_short(__s, traits_type::length(__s))
2565 : __assign_external(__s, traits_type::length(__s)))
2566 : __assign_external(__s);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002567}
Howard Hinnantc51e1022010-05-11 19:42:16 +00002568// append
2569
2570template <class _CharT, class _Traits, class _Allocator>
2571basic_string<_CharT, _Traits, _Allocator>&
Howard Hinnantd17880b2013-06-28 16:59:19 +00002572basic_string<_CharT, _Traits, _Allocator>::append(const value_type* __s, size_type __n)
Howard Hinnantc51e1022010-05-11 19:42:16 +00002573{
Alp Tokerb8a95f52014-05-15 11:27:39 +00002574 _LIBCPP_ASSERT(__n == 0 || __s != nullptr, "string::append received nullptr");
Howard Hinnantc51e1022010-05-11 19:42:16 +00002575 size_type __cap = capacity();
2576 size_type __sz = size();
2577 if (__cap - __sz >= __n)
2578 {
2579 if (__n)
2580 {
Eric Fiselierc1b87a72019-11-16 17:13:26 -05002581 value_type* __p = _VSTD::__to_address(__get_pointer());
Howard Hinnantc51e1022010-05-11 19:42:16 +00002582 traits_type::copy(__p + __sz, __s, __n);
2583 __sz += __n;
2584 __set_size(__sz);
2585 traits_type::assign(__p[__sz], value_type());
2586 }
2587 }
2588 else
2589 __grow_by_and_replace(__cap, __sz + __n - __cap, __sz, __sz, 0, __n, __s);
2590 return *this;
2591}
2592
2593template <class _CharT, class _Traits, class _Allocator>
2594basic_string<_CharT, _Traits, _Allocator>&
2595basic_string<_CharT, _Traits, _Allocator>::append(size_type __n, value_type __c)
2596{
2597 if (__n)
2598 {
2599 size_type __cap = capacity();
2600 size_type __sz = size();
2601 if (__cap - __sz < __n)
2602 __grow_by(__cap, __sz + __n - __cap, __sz, __sz, 0);
2603 pointer __p = __get_pointer();
Eric Fiselierc1b87a72019-11-16 17:13:26 -05002604 traits_type::assign(_VSTD::__to_address(__p) + __sz, __n, __c);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002605 __sz += __n;
2606 __set_size(__sz);
2607 traits_type::assign(__p[__sz], value_type());
2608 }
2609 return *this;
2610}
2611
2612template <class _CharT, class _Traits, class _Allocator>
Eric Fiselier451d5582018-11-26 20:15:38 +00002613inline void
2614basic_string<_CharT, _Traits, _Allocator>::__append_default_init(size_type __n)
2615{
2616 if (__n)
2617 {
2618 size_type __cap = capacity();
2619 size_type __sz = size();
2620 if (__cap - __sz < __n)
2621 __grow_by(__cap, __sz + __n - __cap, __sz, __sz, 0);
2622 pointer __p = __get_pointer();
2623 __sz += __n;
2624 __set_size(__sz);
2625 traits_type::assign(__p[__sz], value_type());
2626 }
2627}
2628
2629template <class _CharT, class _Traits, class _Allocator>
Howard Hinnantc51e1022010-05-11 19:42:16 +00002630void
2631basic_string<_CharT, _Traits, _Allocator>::push_back(value_type __c)
2632{
Howard Hinnant68bf1812013-04-30 21:44:48 +00002633 bool __is_short = !__is_long();
2634 size_type __cap;
2635 size_type __sz;
2636 if (__is_short)
2637 {
2638 __cap = __min_cap - 1;
2639 __sz = __get_short_size();
2640 }
2641 else
2642 {
2643 __cap = __get_long_cap() - 1;
2644 __sz = __get_long_size();
2645 }
Howard Hinnantc51e1022010-05-11 19:42:16 +00002646 if (__sz == __cap)
Howard Hinnant68bf1812013-04-30 21:44:48 +00002647 {
Howard Hinnantc51e1022010-05-11 19:42:16 +00002648 __grow_by(__cap, 1, __sz, __sz, 0);
Howard Hinnant68bf1812013-04-30 21:44:48 +00002649 __is_short = !__is_long();
2650 }
2651 pointer __p;
2652 if (__is_short)
2653 {
2654 __p = __get_short_pointer() + __sz;
2655 __set_short_size(__sz+1);
2656 }
2657 else
2658 {
2659 __p = __get_long_pointer() + __sz;
2660 __set_long_size(__sz+1);
2661 }
Howard Hinnantc51e1022010-05-11 19:42:16 +00002662 traits_type::assign(*__p, __c);
2663 traits_type::assign(*++__p, value_type());
Howard Hinnantc51e1022010-05-11 19:42:16 +00002664}
2665
Howard Hinnantc51e1022010-05-11 19:42:16 +00002666template <class _CharT, class _Traits, class _Allocator>
2667template<class _ForwardIterator>
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04002668_EnableIf
2669<
2670 __is_cpp17_forward_iterator<_ForwardIterator>::value,
2671 basic_string<_CharT, _Traits, _Allocator>&
2672>
2673basic_string<_CharT, _Traits, _Allocator>::append(
Eric Fiselierdb7ee8f2016-10-31 02:46:25 +00002674 _ForwardIterator __first, _ForwardIterator __last)
Howard Hinnantc51e1022010-05-11 19:42:16 +00002675{
2676 size_type __sz = size();
2677 size_type __cap = capacity();
Howard Hinnantb1ad5a82011-06-30 21:18:19 +00002678 size_type __n = static_cast<size_type>(_VSTD::distance(__first, __last));
Howard Hinnantc51e1022010-05-11 19:42:16 +00002679 if (__n)
2680 {
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04002681 if (__string_is_trivial_iterator<_ForwardIterator>::value &&
2682 !__addr_in_range(*__first))
Marshall Clow958362f2016-09-05 01:54:30 +00002683 {
2684 if (__cap - __sz < __n)
2685 __grow_by(__cap, __sz + __n - __cap, __sz, __sz, 0);
2686 pointer __p = __get_pointer() + __sz;
2687 for (; __first != __last; ++__p, ++__first)
2688 traits_type::assign(*__p, *__first);
2689 traits_type::assign(*__p, value_type());
2690 __set_size(__sz + __n);
2691 }
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04002692 else
2693 {
2694 const basic_string __temp(__first, __last, __alloc());
2695 append(__temp.data(), __temp.size());
2696 }
Howard Hinnantc51e1022010-05-11 19:42:16 +00002697 }
2698 return *this;
2699}
2700
2701template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00002702inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00002703basic_string<_CharT, _Traits, _Allocator>&
2704basic_string<_CharT, _Traits, _Allocator>::append(const basic_string& __str)
2705{
2706 return append(__str.data(), __str.size());
2707}
2708
2709template <class _CharT, class _Traits, class _Allocator>
2710basic_string<_CharT, _Traits, _Allocator>&
2711basic_string<_CharT, _Traits, _Allocator>::append(const basic_string& __str, size_type __pos, size_type __n)
2712{
2713 size_type __sz = __str.size();
2714 if (__pos > __sz)
2715 this->__throw_out_of_range();
Howard Hinnantb1ad5a82011-06-30 21:18:19 +00002716 return append(__str.data() + __pos, _VSTD::min(__n, __sz - __pos));
Howard Hinnantc51e1022010-05-11 19:42:16 +00002717}
2718
2719template <class _CharT, class _Traits, class _Allocator>
Marshall Clow62953962016-10-03 23:40:48 +00002720template <class _Tp>
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002721 _EnableIf
Marshall Clow82513342016-09-24 22:45:42 +00002722 <
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002723 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value && !__is_same_uncvref<_Tp, basic_string<_CharT, _Traits, _Allocator> >::value,
Marshall Clow82513342016-09-24 22:45:42 +00002724 basic_string<_CharT, _Traits, _Allocator>&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002725 >
Marshall Clow82513342016-09-24 22:45:42 +00002726basic_string<_CharT, _Traits, _Allocator>::append(const _Tp & __t, size_type __pos, size_type __n)
Marshall Clowdf63a6d2016-07-21 05:31:24 +00002727{
Marshall Clow82513342016-09-24 22:45:42 +00002728 __self_view __sv = __t;
Marshall Clowdf63a6d2016-07-21 05:31:24 +00002729 size_type __sz = __sv.size();
2730 if (__pos > __sz)
2731 this->__throw_out_of_range();
2732 return append(__sv.data() + __pos, _VSTD::min(__n, __sz - __pos));
2733}
2734
2735template <class _CharT, class _Traits, class _Allocator>
Howard Hinnantc51e1022010-05-11 19:42:16 +00002736basic_string<_CharT, _Traits, _Allocator>&
Howard Hinnantd17880b2013-06-28 16:59:19 +00002737basic_string<_CharT, _Traits, _Allocator>::append(const value_type* __s)
Howard Hinnantc51e1022010-05-11 19:42:16 +00002738{
Alp Tokerb8a95f52014-05-15 11:27:39 +00002739 _LIBCPP_ASSERT(__s != nullptr, "string::append received nullptr");
Howard Hinnantc51e1022010-05-11 19:42:16 +00002740 return append(__s, traits_type::length(__s));
2741}
2742
2743// insert
2744
2745template <class _CharT, class _Traits, class _Allocator>
2746basic_string<_CharT, _Traits, _Allocator>&
Howard Hinnantd17880b2013-06-28 16:59:19 +00002747basic_string<_CharT, _Traits, _Allocator>::insert(size_type __pos, const value_type* __s, size_type __n)
Howard Hinnantc51e1022010-05-11 19:42:16 +00002748{
Alp Tokerb8a95f52014-05-15 11:27:39 +00002749 _LIBCPP_ASSERT(__n == 0 || __s != nullptr, "string::insert received nullptr");
Howard Hinnantc51e1022010-05-11 19:42:16 +00002750 size_type __sz = size();
2751 if (__pos > __sz)
2752 this->__throw_out_of_range();
2753 size_type __cap = capacity();
2754 if (__cap - __sz >= __n)
2755 {
2756 if (__n)
2757 {
Eric Fiselierc1b87a72019-11-16 17:13:26 -05002758 value_type* __p = _VSTD::__to_address(__get_pointer());
Howard Hinnantc51e1022010-05-11 19:42:16 +00002759 size_type __n_move = __sz - __pos;
2760 if (__n_move != 0)
2761 {
2762 if (__p + __pos <= __s && __s < __p + __sz)
2763 __s += __n;
2764 traits_type::move(__p + __pos + __n, __p + __pos, __n_move);
2765 }
2766 traits_type::move(__p + __pos, __s, __n);
2767 __sz += __n;
2768 __set_size(__sz);
2769 traits_type::assign(__p[__sz], value_type());
2770 }
2771 }
2772 else
2773 __grow_by_and_replace(__cap, __sz + __n - __cap, __sz, __pos, 0, __n, __s);
2774 return *this;
2775}
2776
2777template <class _CharT, class _Traits, class _Allocator>
2778basic_string<_CharT, _Traits, _Allocator>&
2779basic_string<_CharT, _Traits, _Allocator>::insert(size_type __pos, size_type __n, value_type __c)
2780{
2781 size_type __sz = size();
2782 if (__pos > __sz)
2783 this->__throw_out_of_range();
2784 if (__n)
2785 {
2786 size_type __cap = capacity();
Howard Hinnantd17880b2013-06-28 16:59:19 +00002787 value_type* __p;
Howard Hinnantc51e1022010-05-11 19:42:16 +00002788 if (__cap - __sz >= __n)
2789 {
Eric Fiselierc1b87a72019-11-16 17:13:26 -05002790 __p = _VSTD::__to_address(__get_pointer());
Howard Hinnantc51e1022010-05-11 19:42:16 +00002791 size_type __n_move = __sz - __pos;
2792 if (__n_move != 0)
2793 traits_type::move(__p + __pos + __n, __p + __pos, __n_move);
2794 }
2795 else
2796 {
2797 __grow_by(__cap, __sz + __n - __cap, __sz, __pos, 0, __n);
Eric Fiselierc1b87a72019-11-16 17:13:26 -05002798 __p = _VSTD::__to_address(__get_long_pointer());
Howard Hinnantc51e1022010-05-11 19:42:16 +00002799 }
2800 traits_type::assign(__p + __pos, __n, __c);
2801 __sz += __n;
2802 __set_size(__sz);
2803 traits_type::assign(__p[__sz], value_type());
2804 }
2805 return *this;
2806}
2807
2808template <class _CharT, class _Traits, class _Allocator>
2809template<class _InputIterator>
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002810_EnableIf
Howard Hinnantc51e1022010-05-11 19:42:16 +00002811<
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04002812 __is_exactly_cpp17_input_iterator<_InputIterator>::value,
Marshall Clow039b2f02016-01-13 21:54:34 +00002813 typename basic_string<_CharT, _Traits, _Allocator>::iterator
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002814>
Howard Hinnantc51e1022010-05-11 19:42:16 +00002815basic_string<_CharT, _Traits, _Allocator>::insert(const_iterator __pos, _InputIterator __first, _InputIterator __last)
2816{
Louis Dionneba400782020-10-02 15:02:52 -04002817#if _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnant8ea98242013-08-23 17:37:05 +00002818 _LIBCPP_ASSERT(__get_const_db()->__find_c_from_i(&__pos) == this,
2819 "string::insert(iterator, range) called with an iterator not"
2820 " referring to this string");
2821#endif
Marshall Clow958362f2016-09-05 01:54:30 +00002822 const basic_string __temp(__first, __last, __alloc());
Marshall Clow039b2f02016-01-13 21:54:34 +00002823 return insert(__pos, __temp.data(), __temp.data() + __temp.size());
Howard Hinnantc51e1022010-05-11 19:42:16 +00002824}
2825
2826template <class _CharT, class _Traits, class _Allocator>
2827template<class _ForwardIterator>
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002828_EnableIf
Howard Hinnantc51e1022010-05-11 19:42:16 +00002829<
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04002830 __is_cpp17_forward_iterator<_ForwardIterator>::value,
Howard Hinnantc51e1022010-05-11 19:42:16 +00002831 typename basic_string<_CharT, _Traits, _Allocator>::iterator
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002832>
Howard Hinnantc51e1022010-05-11 19:42:16 +00002833basic_string<_CharT, _Traits, _Allocator>::insert(const_iterator __pos, _ForwardIterator __first, _ForwardIterator __last)
2834{
Louis Dionneba400782020-10-02 15:02:52 -04002835#if _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnant8ea98242013-08-23 17:37:05 +00002836 _LIBCPP_ASSERT(__get_const_db()->__find_c_from_i(&__pos) == this,
2837 "string::insert(iterator, range) called with an iterator not"
2838 " referring to this string");
2839#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +00002840 size_type __ip = static_cast<size_type>(__pos - begin());
Howard Hinnantb1ad5a82011-06-30 21:18:19 +00002841 size_type __n = static_cast<size_type>(_VSTD::distance(__first, __last));
Howard Hinnantc51e1022010-05-11 19:42:16 +00002842 if (__n)
2843 {
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04002844 if (__string_is_trivial_iterator<_ForwardIterator>::value &&
2845 !__addr_in_range(*__first))
2846 {
2847 size_type __sz = size();
2848 size_type __cap = capacity();
2849 value_type* __p;
2850 if (__cap - __sz >= __n)
2851 {
2852 __p = _VSTD::__to_address(__get_pointer());
2853 size_type __n_move = __sz - __ip;
2854 if (__n_move != 0)
2855 traits_type::move(__p + __ip + __n, __p + __ip, __n_move);
2856 }
2857 else
2858 {
2859 __grow_by(__cap, __sz + __n - __cap, __sz, __ip, 0, __n);
2860 __p = _VSTD::__to_address(__get_long_pointer());
2861 }
2862 __sz += __n;
2863 __set_size(__sz);
2864 traits_type::assign(__p[__sz], value_type());
2865 for (__p += __ip; __first != __last; ++__p, ++__first)
2866 traits_type::assign(*__p, *__first);
2867 }
2868 else
Marshall Clow958362f2016-09-05 01:54:30 +00002869 {
2870 const basic_string __temp(__first, __last, __alloc());
2871 return insert(__pos, __temp.data(), __temp.data() + __temp.size());
2872 }
Howard Hinnantc51e1022010-05-11 19:42:16 +00002873 }
2874 return begin() + __ip;
2875}
2876
2877template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00002878inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00002879basic_string<_CharT, _Traits, _Allocator>&
2880basic_string<_CharT, _Traits, _Allocator>::insert(size_type __pos1, const basic_string& __str)
2881{
2882 return insert(__pos1, __str.data(), __str.size());
2883}
2884
2885template <class _CharT, class _Traits, class _Allocator>
2886basic_string<_CharT, _Traits, _Allocator>&
2887basic_string<_CharT, _Traits, _Allocator>::insert(size_type __pos1, const basic_string& __str,
2888 size_type __pos2, size_type __n)
2889{
2890 size_type __str_sz = __str.size();
2891 if (__pos2 > __str_sz)
2892 this->__throw_out_of_range();
Howard Hinnantb1ad5a82011-06-30 21:18:19 +00002893 return insert(__pos1, __str.data() + __pos2, _VSTD::min(__n, __str_sz - __pos2));
Howard Hinnantc51e1022010-05-11 19:42:16 +00002894}
2895
2896template <class _CharT, class _Traits, class _Allocator>
Marshall Clow82513342016-09-24 22:45:42 +00002897template <class _Tp>
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002898_EnableIf
Marshall Clow82513342016-09-24 22:45:42 +00002899<
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002900 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value && !__is_same_uncvref<_Tp, basic_string<_CharT, _Traits, _Allocator> >::value,
Marshall Clowb7db4972017-11-15 20:02:27 +00002901 basic_string<_CharT, _Traits, _Allocator>&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002902>
Marshall Clow82513342016-09-24 22:45:42 +00002903basic_string<_CharT, _Traits, _Allocator>::insert(size_type __pos1, const _Tp& __t,
Marshall Clowdf63a6d2016-07-21 05:31:24 +00002904 size_type __pos2, size_type __n)
2905{
Marshall Clow82513342016-09-24 22:45:42 +00002906 __self_view __sv = __t;
Marshall Clowdf63a6d2016-07-21 05:31:24 +00002907 size_type __str_sz = __sv.size();
2908 if (__pos2 > __str_sz)
2909 this->__throw_out_of_range();
2910 return insert(__pos1, __sv.data() + __pos2, _VSTD::min(__n, __str_sz - __pos2));
2911}
2912
2913template <class _CharT, class _Traits, class _Allocator>
Howard Hinnantc51e1022010-05-11 19:42:16 +00002914basic_string<_CharT, _Traits, _Allocator>&
Howard Hinnantd17880b2013-06-28 16:59:19 +00002915basic_string<_CharT, _Traits, _Allocator>::insert(size_type __pos, const value_type* __s)
Howard Hinnantc51e1022010-05-11 19:42:16 +00002916{
Alp Tokerb8a95f52014-05-15 11:27:39 +00002917 _LIBCPP_ASSERT(__s != nullptr, "string::insert received nullptr");
Howard Hinnantc51e1022010-05-11 19:42:16 +00002918 return insert(__pos, __s, traits_type::length(__s));
2919}
2920
2921template <class _CharT, class _Traits, class _Allocator>
2922typename basic_string<_CharT, _Traits, _Allocator>::iterator
2923basic_string<_CharT, _Traits, _Allocator>::insert(const_iterator __pos, value_type __c)
2924{
2925 size_type __ip = static_cast<size_type>(__pos - begin());
2926 size_type __sz = size();
2927 size_type __cap = capacity();
Howard Hinnantd17880b2013-06-28 16:59:19 +00002928 value_type* __p;
Howard Hinnantc51e1022010-05-11 19:42:16 +00002929 if (__cap == __sz)
2930 {
2931 __grow_by(__cap, 1, __sz, __ip, 0, 1);
Eric Fiselierc1b87a72019-11-16 17:13:26 -05002932 __p = _VSTD::__to_address(__get_long_pointer());
Howard Hinnantc51e1022010-05-11 19:42:16 +00002933 }
2934 else
2935 {
Eric Fiselierc1b87a72019-11-16 17:13:26 -05002936 __p = _VSTD::__to_address(__get_pointer());
Howard Hinnantc51e1022010-05-11 19:42:16 +00002937 size_type __n_move = __sz - __ip;
2938 if (__n_move != 0)
2939 traits_type::move(__p + __ip + 1, __p + __ip, __n_move);
2940 }
2941 traits_type::assign(__p[__ip], __c);
2942 traits_type::assign(__p[++__sz], value_type());
2943 __set_size(__sz);
2944 return begin() + static_cast<difference_type>(__ip);
2945}
2946
2947template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00002948inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00002949typename basic_string<_CharT, _Traits, _Allocator>::iterator
2950basic_string<_CharT, _Traits, _Allocator>::insert(const_iterator __pos, size_type __n, value_type __c)
2951{
Louis Dionneba400782020-10-02 15:02:52 -04002952#if _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnant8ea98242013-08-23 17:37:05 +00002953 _LIBCPP_ASSERT(__get_const_db()->__find_c_from_i(&__pos) == this,
2954 "string::insert(iterator, n, value) called with an iterator not"
2955 " referring to this string");
2956#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +00002957 difference_type __p = __pos - begin();
2958 insert(static_cast<size_type>(__p), __n, __c);
2959 return begin() + __p;
2960}
2961
2962// replace
2963
2964template <class _CharT, class _Traits, class _Allocator>
2965basic_string<_CharT, _Traits, _Allocator>&
Howard Hinnantd17880b2013-06-28 16:59:19 +00002966basic_string<_CharT, _Traits, _Allocator>::replace(size_type __pos, size_type __n1, const value_type* __s, size_type __n2)
Eric Fiseliere5b21842017-03-09 01:54:13 +00002967 _LIBCPP_DISABLE_UBSAN_UNSIGNED_INTEGER_CHECK
Howard Hinnantc51e1022010-05-11 19:42:16 +00002968{
Alp Tokerb8a95f52014-05-15 11:27:39 +00002969 _LIBCPP_ASSERT(__n2 == 0 || __s != nullptr, "string::replace received nullptr");
Howard Hinnantc51e1022010-05-11 19:42:16 +00002970 size_type __sz = size();
2971 if (__pos > __sz)
2972 this->__throw_out_of_range();
Howard Hinnantb1ad5a82011-06-30 21:18:19 +00002973 __n1 = _VSTD::min(__n1, __sz - __pos);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002974 size_type __cap = capacity();
2975 if (__cap - __sz + __n1 >= __n2)
2976 {
Eric Fiselierc1b87a72019-11-16 17:13:26 -05002977 value_type* __p = _VSTD::__to_address(__get_pointer());
Howard Hinnantc51e1022010-05-11 19:42:16 +00002978 if (__n1 != __n2)
2979 {
2980 size_type __n_move = __sz - __pos - __n1;
2981 if (__n_move != 0)
2982 {
2983 if (__n1 > __n2)
2984 {
2985 traits_type::move(__p + __pos, __s, __n2);
2986 traits_type::move(__p + __pos + __n2, __p + __pos + __n1, __n_move);
2987 goto __finish;
2988 }
2989 if (__p + __pos < __s && __s < __p + __sz)
2990 {
2991 if (__p + __pos + __n1 <= __s)
2992 __s += __n2 - __n1;
2993 else // __p + __pos < __s < __p + __pos + __n1
2994 {
2995 traits_type::move(__p + __pos, __s, __n1);
2996 __pos += __n1;
2997 __s += __n2;
2998 __n2 -= __n1;
2999 __n1 = 0;
3000 }
3001 }
3002 traits_type::move(__p + __pos + __n2, __p + __pos + __n1, __n_move);
3003 }
3004 }
3005 traits_type::move(__p + __pos, __s, __n2);
3006__finish:
Martijn Vels1c48afb2020-01-28 13:43:19 -05003007// __sz += __n2 - __n1; in this and the below function below can cause unsigned
3008// integer overflow, but this is a safe operation, so we disable the check.
Howard Hinnantc51e1022010-05-11 19:42:16 +00003009 __sz += __n2 - __n1;
3010 __set_size(__sz);
3011 __invalidate_iterators_past(__sz);
3012 traits_type::assign(__p[__sz], value_type());
3013 }
3014 else
3015 __grow_by_and_replace(__cap, __sz - __n1 + __n2 - __cap, __sz, __pos, __n1, __n2, __s);
3016 return *this;
3017}
3018
3019template <class _CharT, class _Traits, class _Allocator>
3020basic_string<_CharT, _Traits, _Allocator>&
3021basic_string<_CharT, _Traits, _Allocator>::replace(size_type __pos, size_type __n1, size_type __n2, value_type __c)
Eric Fiseliere5b21842017-03-09 01:54:13 +00003022 _LIBCPP_DISABLE_UBSAN_UNSIGNED_INTEGER_CHECK
Howard Hinnantc51e1022010-05-11 19:42:16 +00003023{
3024 size_type __sz = size();
3025 if (__pos > __sz)
3026 this->__throw_out_of_range();
Howard Hinnantb1ad5a82011-06-30 21:18:19 +00003027 __n1 = _VSTD::min(__n1, __sz - __pos);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003028 size_type __cap = capacity();
Howard Hinnantd17880b2013-06-28 16:59:19 +00003029 value_type* __p;
Howard Hinnantc51e1022010-05-11 19:42:16 +00003030 if (__cap - __sz + __n1 >= __n2)
3031 {
Eric Fiselierc1b87a72019-11-16 17:13:26 -05003032 __p = _VSTD::__to_address(__get_pointer());
Howard Hinnantc51e1022010-05-11 19:42:16 +00003033 if (__n1 != __n2)
3034 {
3035 size_type __n_move = __sz - __pos - __n1;
3036 if (__n_move != 0)
3037 traits_type::move(__p + __pos + __n2, __p + __pos + __n1, __n_move);
3038 }
3039 }
3040 else
3041 {
3042 __grow_by(__cap, __sz - __n1 + __n2 - __cap, __sz, __pos, __n1, __n2);
Eric Fiselierc1b87a72019-11-16 17:13:26 -05003043 __p = _VSTD::__to_address(__get_long_pointer());
Howard Hinnantc51e1022010-05-11 19:42:16 +00003044 }
3045 traits_type::assign(__p + __pos, __n2, __c);
3046 __sz += __n2 - __n1;
3047 __set_size(__sz);
3048 __invalidate_iterators_past(__sz);
3049 traits_type::assign(__p[__sz], value_type());
3050 return *this;
3051}
3052
3053template <class _CharT, class _Traits, class _Allocator>
3054template<class _InputIterator>
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003055_EnableIf
Howard Hinnantc51e1022010-05-11 19:42:16 +00003056<
Eric Fiseliercd5a6772019-11-18 01:46:58 -05003057 __is_cpp17_input_iterator<_InputIterator>::value,
Howard Hinnantc51e1022010-05-11 19:42:16 +00003058 basic_string<_CharT, _Traits, _Allocator>&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003059>
Howard Hinnant990d6e82010-11-17 21:11:40 +00003060basic_string<_CharT, _Traits, _Allocator>::replace(const_iterator __i1, const_iterator __i2,
Howard Hinnantc51e1022010-05-11 19:42:16 +00003061 _InputIterator __j1, _InputIterator __j2)
3062{
Marshall Clow958362f2016-09-05 01:54:30 +00003063 const basic_string __temp(__j1, __j2, __alloc());
Marshall Clow039b2f02016-01-13 21:54:34 +00003064 return this->replace(__i1, __i2, __temp);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003065}
3066
3067template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003068inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00003069basic_string<_CharT, _Traits, _Allocator>&
3070basic_string<_CharT, _Traits, _Allocator>::replace(size_type __pos1, size_type __n1, const basic_string& __str)
3071{
3072 return replace(__pos1, __n1, __str.data(), __str.size());
3073}
3074
3075template <class _CharT, class _Traits, class _Allocator>
3076basic_string<_CharT, _Traits, _Allocator>&
3077basic_string<_CharT, _Traits, _Allocator>::replace(size_type __pos1, size_type __n1, const basic_string& __str,
3078 size_type __pos2, size_type __n2)
3079{
3080 size_type __str_sz = __str.size();
3081 if (__pos2 > __str_sz)
3082 this->__throw_out_of_range();
Howard Hinnantb1ad5a82011-06-30 21:18:19 +00003083 return replace(__pos1, __n1, __str.data() + __pos2, _VSTD::min(__n2, __str_sz - __pos2));
Howard Hinnantc51e1022010-05-11 19:42:16 +00003084}
3085
3086template <class _CharT, class _Traits, class _Allocator>
Marshall Clow82513342016-09-24 22:45:42 +00003087template <class _Tp>
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003088_EnableIf
Marshall Clow82513342016-09-24 22:45:42 +00003089<
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003090 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value && !__is_same_uncvref<_Tp, basic_string<_CharT, _Traits, _Allocator> >::value,
Marshall Clowb7db4972017-11-15 20:02:27 +00003091 basic_string<_CharT, _Traits, _Allocator>&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003092>
Marshall Clow82513342016-09-24 22:45:42 +00003093basic_string<_CharT, _Traits, _Allocator>::replace(size_type __pos1, size_type __n1, const _Tp& __t,
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003094 size_type __pos2, size_type __n2)
3095{
Marshall Clow82513342016-09-24 22:45:42 +00003096 __self_view __sv = __t;
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003097 size_type __str_sz = __sv.size();
3098 if (__pos2 > __str_sz)
3099 this->__throw_out_of_range();
3100 return replace(__pos1, __n1, __sv.data() + __pos2, _VSTD::min(__n2, __str_sz - __pos2));
3101}
3102
3103template <class _CharT, class _Traits, class _Allocator>
3104basic_string<_CharT, _Traits, _Allocator>&
Howard Hinnantd17880b2013-06-28 16:59:19 +00003105basic_string<_CharT, _Traits, _Allocator>::replace(size_type __pos, size_type __n1, const value_type* __s)
Howard Hinnantc51e1022010-05-11 19:42:16 +00003106{
Alp Tokerb8a95f52014-05-15 11:27:39 +00003107 _LIBCPP_ASSERT(__s != nullptr, "string::replace received nullptr");
Howard Hinnantc51e1022010-05-11 19:42:16 +00003108 return replace(__pos, __n1, __s, traits_type::length(__s));
3109}
3110
3111template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003112inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00003113basic_string<_CharT, _Traits, _Allocator>&
Howard Hinnant990d6e82010-11-17 21:11:40 +00003114basic_string<_CharT, _Traits, _Allocator>::replace(const_iterator __i1, const_iterator __i2, const basic_string& __str)
Howard Hinnantc51e1022010-05-11 19:42:16 +00003115{
3116 return replace(static_cast<size_type>(__i1 - begin()), static_cast<size_type>(__i2 - __i1),
3117 __str.data(), __str.size());
3118}
3119
3120template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003121inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00003122basic_string<_CharT, _Traits, _Allocator>&
Howard Hinnantd17880b2013-06-28 16:59:19 +00003123basic_string<_CharT, _Traits, _Allocator>::replace(const_iterator __i1, const_iterator __i2, const value_type* __s, size_type __n)
Howard Hinnantc51e1022010-05-11 19:42:16 +00003124{
3125 return replace(static_cast<size_type>(__i1 - begin()), static_cast<size_type>(__i2 - __i1), __s, __n);
3126}
3127
3128template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003129inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00003130basic_string<_CharT, _Traits, _Allocator>&
Howard Hinnantd17880b2013-06-28 16:59:19 +00003131basic_string<_CharT, _Traits, _Allocator>::replace(const_iterator __i1, const_iterator __i2, const value_type* __s)
Howard Hinnantc51e1022010-05-11 19:42:16 +00003132{
3133 return replace(static_cast<size_type>(__i1 - begin()), static_cast<size_type>(__i2 - __i1), __s);
3134}
3135
3136template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003137inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00003138basic_string<_CharT, _Traits, _Allocator>&
Howard Hinnant990d6e82010-11-17 21:11:40 +00003139basic_string<_CharT, _Traits, _Allocator>::replace(const_iterator __i1, const_iterator __i2, size_type __n, value_type __c)
Howard Hinnantc51e1022010-05-11 19:42:16 +00003140{
3141 return replace(static_cast<size_type>(__i1 - begin()), static_cast<size_type>(__i2 - __i1), __n, __c);
3142}
3143
3144// erase
3145
Martijn Velsa81fc792020-02-26 13:25:43 -05003146// 'externally instantiated' erase() implementation, called when __n != npos.
3147// Does not check __pos against size()
Howard Hinnantc51e1022010-05-11 19:42:16 +00003148template <class _CharT, class _Traits, class _Allocator>
Martijn Velsa81fc792020-02-26 13:25:43 -05003149void
3150basic_string<_CharT, _Traits, _Allocator>::__erase_external_with_move(
3151 size_type __pos, size_type __n)
Howard Hinnantc51e1022010-05-11 19:42:16 +00003152{
Howard Hinnantc51e1022010-05-11 19:42:16 +00003153 if (__n)
3154 {
Martijn Velsa81fc792020-02-26 13:25:43 -05003155 size_type __sz = size();
Eric Fiselierc1b87a72019-11-16 17:13:26 -05003156 value_type* __p = _VSTD::__to_address(__get_pointer());
Howard Hinnantb1ad5a82011-06-30 21:18:19 +00003157 __n = _VSTD::min(__n, __sz - __pos);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003158 size_type __n_move = __sz - __pos - __n;
3159 if (__n_move != 0)
3160 traits_type::move(__p + __pos, __p + __pos + __n, __n_move);
3161 __sz -= __n;
3162 __set_size(__sz);
3163 __invalidate_iterators_past(__sz);
3164 traits_type::assign(__p[__sz], value_type());
3165 }
Martijn Velsa81fc792020-02-26 13:25:43 -05003166}
3167
3168template <class _CharT, class _Traits, class _Allocator>
3169basic_string<_CharT, _Traits, _Allocator>&
3170basic_string<_CharT, _Traits, _Allocator>::erase(size_type __pos,
3171 size_type __n) {
3172 if (__pos > size()) this->__throw_out_of_range();
3173 if (__n == npos) {
3174 __erase_to_end(__pos);
3175 } else {
3176 __erase_external_with_move(__pos, __n);
3177 }
3178 return *this;
Howard Hinnantc51e1022010-05-11 19:42:16 +00003179}
3180
3181template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003182inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00003183typename basic_string<_CharT, _Traits, _Allocator>::iterator
3184basic_string<_CharT, _Traits, _Allocator>::erase(const_iterator __pos)
3185{
Louis Dionneba400782020-10-02 15:02:52 -04003186#if _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnant8ea98242013-08-23 17:37:05 +00003187 _LIBCPP_ASSERT(__get_const_db()->__find_c_from_i(&__pos) == this,
3188 "string::erase(iterator) called with an iterator not"
3189 " referring to this string");
3190#endif
3191 _LIBCPP_ASSERT(__pos != end(),
3192 "string::erase(iterator) called with a non-dereferenceable iterator");
Howard Hinnantc51e1022010-05-11 19:42:16 +00003193 iterator __b = begin();
3194 size_type __r = static_cast<size_type>(__pos - __b);
3195 erase(__r, 1);
Howard Hinnant28b24882011-12-01 20:21:04 +00003196 return __b + static_cast<difference_type>(__r);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003197}
3198
3199template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003200inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00003201typename basic_string<_CharT, _Traits, _Allocator>::iterator
3202basic_string<_CharT, _Traits, _Allocator>::erase(const_iterator __first, const_iterator __last)
3203{
Louis Dionneba400782020-10-02 15:02:52 -04003204#if _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnant8ea98242013-08-23 17:37:05 +00003205 _LIBCPP_ASSERT(__get_const_db()->__find_c_from_i(&__first) == this,
3206 "string::erase(iterator, iterator) called with an iterator not"
3207 " referring to this string");
3208#endif
3209 _LIBCPP_ASSERT(__first <= __last, "string::erase(first, last) called with invalid range");
Howard Hinnantc51e1022010-05-11 19:42:16 +00003210 iterator __b = begin();
3211 size_type __r = static_cast<size_type>(__first - __b);
3212 erase(__r, static_cast<size_type>(__last - __first));
Howard Hinnant28b24882011-12-01 20:21:04 +00003213 return __b + static_cast<difference_type>(__r);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003214}
3215
3216template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003217inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00003218void
3219basic_string<_CharT, _Traits, _Allocator>::pop_back()
3220{
Howard Hinnant8ea98242013-08-23 17:37:05 +00003221 _LIBCPP_ASSERT(!empty(), "string::pop_back(): string is already empty");
Howard Hinnantc51e1022010-05-11 19:42:16 +00003222 size_type __sz;
3223 if (__is_long())
3224 {
3225 __sz = __get_long_size() - 1;
3226 __set_long_size(__sz);
3227 traits_type::assign(*(__get_long_pointer() + __sz), value_type());
3228 }
3229 else
3230 {
3231 __sz = __get_short_size() - 1;
3232 __set_short_size(__sz);
3233 traits_type::assign(*(__get_short_pointer() + __sz), value_type());
3234 }
3235 __invalidate_iterators_past(__sz);
3236}
3237
3238template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003239inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00003240void
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003241basic_string<_CharT, _Traits, _Allocator>::clear() _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003242{
3243 __invalidate_all_iterators();
3244 if (__is_long())
3245 {
3246 traits_type::assign(*__get_long_pointer(), value_type());
3247 __set_long_size(0);
3248 }
3249 else
3250 {
3251 traits_type::assign(*__get_short_pointer(), value_type());
3252 __set_short_size(0);
3253 }
3254}
3255
3256template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003257inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00003258void
3259basic_string<_CharT, _Traits, _Allocator>::__erase_to_end(size_type __pos)
3260{
3261 if (__is_long())
3262 {
3263 traits_type::assign(*(__get_long_pointer() + __pos), value_type());
3264 __set_long_size(__pos);
3265 }
3266 else
3267 {
3268 traits_type::assign(*(__get_short_pointer() + __pos), value_type());
3269 __set_short_size(__pos);
3270 }
3271 __invalidate_iterators_past(__pos);
3272}
3273
3274template <class _CharT, class _Traits, class _Allocator>
3275void
3276basic_string<_CharT, _Traits, _Allocator>::resize(size_type __n, value_type __c)
3277{
3278 size_type __sz = size();
3279 if (__n > __sz)
3280 append(__n - __sz, __c);
3281 else
3282 __erase_to_end(__n);
3283}
3284
3285template <class _CharT, class _Traits, class _Allocator>
Eric Fiselier451d5582018-11-26 20:15:38 +00003286inline void
3287basic_string<_CharT, _Traits, _Allocator>::__resize_default_init(size_type __n)
3288{
3289 size_type __sz = size();
3290 if (__n > __sz) {
3291 __append_default_init(__n - __sz);
3292 } else
3293 __erase_to_end(__n);
3294}
3295
3296template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003297inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00003298typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003299basic_string<_CharT, _Traits, _Allocator>::max_size() const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003300{
Howard Hinnantea8f7e12010-11-17 17:55:08 +00003301 size_type __m = __alloc_traits::max_size(__alloc());
Eric Fiseliere9cc5922017-10-17 13:16:01 +00003302#ifdef _LIBCPP_BIG_ENDIAN
Marshall Clow6dd6cb72013-10-31 17:23:08 +00003303 return (__m <= ~__long_mask ? __m : __m/2) - __alignment;
Howard Hinnantc51e1022010-05-11 19:42:16 +00003304#else
Marshall Clow6dd6cb72013-10-31 17:23:08 +00003305 return __m - __alignment;
Howard Hinnantc51e1022010-05-11 19:42:16 +00003306#endif
3307}
3308
3309template <class _CharT, class _Traits, class _Allocator>
3310void
Marek Kurdejc9848142020-11-26 10:07:16 +01003311basic_string<_CharT, _Traits, _Allocator>::reserve(size_type __requested_capacity)
Howard Hinnantc51e1022010-05-11 19:42:16 +00003312{
Marek Kurdejc9848142020-11-26 10:07:16 +01003313 if (__requested_capacity > max_size())
Howard Hinnantc51e1022010-05-11 19:42:16 +00003314 this->__throw_length_error();
Marek Kurdejc9848142020-11-26 10:07:16 +01003315
3316#if _LIBCPP_STD_VER > 17
3317 // Reserve never shrinks as of C++20.
3318 if (__requested_capacity <= capacity()) return;
3319#endif
3320
3321 size_type __target_capacity = _VSTD::max(__requested_capacity, size());
3322 __target_capacity = __recommend(__target_capacity);
3323 if (__target_capacity == capacity()) return;
3324
3325 __shrink_or_extend(__target_capacity);
3326}
3327
3328template <class _CharT, class _Traits, class _Allocator>
3329void
3330basic_string<_CharT, _Traits, _Allocator>::shrink_to_fit() _NOEXCEPT
3331{
3332 size_type __target_capacity = __recommend(size());
3333 if (__target_capacity == capacity()) return;
3334
3335 __shrink_or_extend(__target_capacity);
3336}
3337
3338template <class _CharT, class _Traits, class _Allocator>
3339void
3340basic_string<_CharT, _Traits, _Allocator>::__shrink_or_extend(size_type __target_capacity)
3341{
Howard Hinnantc51e1022010-05-11 19:42:16 +00003342 size_type __cap = capacity();
3343 size_type __sz = size();
Marek Kurdejc9848142020-11-26 10:07:16 +01003344
3345 pointer __new_data, __p;
3346 bool __was_long, __now_long;
3347 if (__target_capacity == __min_cap - 1)
Howard Hinnantc51e1022010-05-11 19:42:16 +00003348 {
Marek Kurdejc9848142020-11-26 10:07:16 +01003349 __was_long = true;
3350 __now_long = false;
3351 __new_data = __get_short_pointer();
3352 __p = __get_long_pointer();
Howard Hinnantc51e1022010-05-11 19:42:16 +00003353 }
Marek Kurdejc9848142020-11-26 10:07:16 +01003354 else
3355 {
3356 if (__target_capacity > __cap)
3357 __new_data = __alloc_traits::allocate(__alloc(), __target_capacity+1);
3358 else
3359 {
3360 #ifndef _LIBCPP_NO_EXCEPTIONS
3361 try
3362 {
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04003363 #endif // _LIBCPP_NO_EXCEPTIONS
Marek Kurdejc9848142020-11-26 10:07:16 +01003364 __new_data = __alloc_traits::allocate(__alloc(), __target_capacity+1);
3365 #ifndef _LIBCPP_NO_EXCEPTIONS
3366 }
3367 catch (...)
3368 {
3369 return;
3370 }
3371 #else // _LIBCPP_NO_EXCEPTIONS
3372 if (__new_data == nullptr)
3373 return;
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04003374 #endif // _LIBCPP_NO_EXCEPTIONS
Marek Kurdejc9848142020-11-26 10:07:16 +01003375 }
3376 __now_long = true;
3377 __was_long = __is_long();
3378 __p = __get_pointer();
3379 }
3380 traits_type::copy(_VSTD::__to_address(__new_data),
3381 _VSTD::__to_address(__p), size()+1);
3382 if (__was_long)
3383 __alloc_traits::deallocate(__alloc(), __p, __cap+1);
3384 if (__now_long)
3385 {
3386 __set_long_cap(__target_capacity+1);
3387 __set_long_size(__sz);
3388 __set_long_pointer(__new_data);
3389 }
3390 else
3391 __set_short_size(__sz);
3392 __invalidate_all_iterators();
Howard Hinnantc51e1022010-05-11 19:42:16 +00003393}
3394
3395template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003396inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00003397typename basic_string<_CharT, _Traits, _Allocator>::const_reference
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003398basic_string<_CharT, _Traits, _Allocator>::operator[](size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003399{
Howard Hinnant8ea98242013-08-23 17:37:05 +00003400 _LIBCPP_ASSERT(__pos <= size(), "string index out of bounds");
Howard Hinnantc51e1022010-05-11 19:42:16 +00003401 return *(data() + __pos);
3402}
3403
3404template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003405inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00003406typename basic_string<_CharT, _Traits, _Allocator>::reference
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003407basic_string<_CharT, _Traits, _Allocator>::operator[](size_type __pos) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003408{
Howard Hinnant8ea98242013-08-23 17:37:05 +00003409 _LIBCPP_ASSERT(__pos <= size(), "string index out of bounds");
Howard Hinnantc51e1022010-05-11 19:42:16 +00003410 return *(__get_pointer() + __pos);
3411}
3412
3413template <class _CharT, class _Traits, class _Allocator>
3414typename basic_string<_CharT, _Traits, _Allocator>::const_reference
3415basic_string<_CharT, _Traits, _Allocator>::at(size_type __n) const
3416{
3417 if (__n >= size())
3418 this->__throw_out_of_range();
3419 return (*this)[__n];
3420}
3421
3422template <class _CharT, class _Traits, class _Allocator>
3423typename basic_string<_CharT, _Traits, _Allocator>::reference
3424basic_string<_CharT, _Traits, _Allocator>::at(size_type __n)
3425{
3426 if (__n >= size())
3427 this->__throw_out_of_range();
3428 return (*this)[__n];
3429}
3430
3431template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003432inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00003433typename basic_string<_CharT, _Traits, _Allocator>::reference
Marshall Clow05cf6692019-03-19 03:30:07 +00003434basic_string<_CharT, _Traits, _Allocator>::front() _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003435{
Howard Hinnant8ea98242013-08-23 17:37:05 +00003436 _LIBCPP_ASSERT(!empty(), "string::front(): string is empty");
Howard Hinnantc51e1022010-05-11 19:42:16 +00003437 return *__get_pointer();
3438}
3439
3440template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003441inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00003442typename basic_string<_CharT, _Traits, _Allocator>::const_reference
Marshall Clow05cf6692019-03-19 03:30:07 +00003443basic_string<_CharT, _Traits, _Allocator>::front() const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003444{
Howard Hinnant8ea98242013-08-23 17:37:05 +00003445 _LIBCPP_ASSERT(!empty(), "string::front(): string is empty");
Howard Hinnantc51e1022010-05-11 19:42:16 +00003446 return *data();
3447}
3448
3449template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003450inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00003451typename basic_string<_CharT, _Traits, _Allocator>::reference
Marshall Clow05cf6692019-03-19 03:30:07 +00003452basic_string<_CharT, _Traits, _Allocator>::back() _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003453{
Howard Hinnant8ea98242013-08-23 17:37:05 +00003454 _LIBCPP_ASSERT(!empty(), "string::back(): string is empty");
Howard Hinnantc51e1022010-05-11 19:42:16 +00003455 return *(__get_pointer() + size() - 1);
3456}
3457
3458template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003459inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00003460typename basic_string<_CharT, _Traits, _Allocator>::const_reference
Marshall Clow05cf6692019-03-19 03:30:07 +00003461basic_string<_CharT, _Traits, _Allocator>::back() const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003462{
Howard Hinnant8ea98242013-08-23 17:37:05 +00003463 _LIBCPP_ASSERT(!empty(), "string::back(): string is empty");
Howard Hinnantc51e1022010-05-11 19:42:16 +00003464 return *(data() + size() - 1);
3465}
3466
3467template <class _CharT, class _Traits, class _Allocator>
3468typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantd17880b2013-06-28 16:59:19 +00003469basic_string<_CharT, _Traits, _Allocator>::copy(value_type* __s, size_type __n, size_type __pos) const
Howard Hinnantc51e1022010-05-11 19:42:16 +00003470{
3471 size_type __sz = size();
3472 if (__pos > __sz)
3473 this->__throw_out_of_range();
Howard Hinnantb1ad5a82011-06-30 21:18:19 +00003474 size_type __rlen = _VSTD::min(__n, __sz - __pos);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003475 traits_type::copy(__s, data() + __pos, __rlen);
3476 return __rlen;
3477}
3478
3479template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003480inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00003481basic_string<_CharT, _Traits, _Allocator>
3482basic_string<_CharT, _Traits, _Allocator>::substr(size_type __pos, size_type __n) const
3483{
3484 return basic_string(*this, __pos, __n, __alloc());
3485}
3486
3487template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003488inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00003489void
3490basic_string<_CharT, _Traits, _Allocator>::swap(basic_string& __str)
Marshall Clow8982dcd2015-07-13 20:04:56 +00003491#if _LIBCPP_STD_VER >= 14
Eric Fiselier873b8d32019-03-18 21:50:12 +00003492 _NOEXCEPT
Marshall Clow8982dcd2015-07-13 20:04:56 +00003493#else
Eric Fiselier873b8d32019-03-18 21:50:12 +00003494 _NOEXCEPT_(!__alloc_traits::propagate_on_container_swap::value ||
Marshall Clow8982dcd2015-07-13 20:04:56 +00003495 __is_nothrow_swappable<allocator_type>::value)
3496#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +00003497{
Louis Dionneba400782020-10-02 15:02:52 -04003498#if _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnant8ea98242013-08-23 17:37:05 +00003499 if (!__is_long())
3500 __get_db()->__invalidate_all(this);
3501 if (!__str.__is_long())
3502 __get_db()->__invalidate_all(&__str);
3503 __get_db()->swap(this, &__str);
3504#endif
Eric Fiselier9bf691f2016-12-28 05:53:01 +00003505 _LIBCPP_ASSERT(
3506 __alloc_traits::propagate_on_container_swap::value ||
3507 __alloc_traits::is_always_equal::value ||
3508 __alloc() == __str.__alloc(), "swapping non-equal allocators");
Howard Hinnantb1ad5a82011-06-30 21:18:19 +00003509 _VSTD::swap(__r_.first(), __str.__r_.first());
Arthur O'Dwyer4e0de312020-11-18 18:54:38 -05003510 _VSTD::__swap_allocator(__alloc(), __str.__alloc());
Howard Hinnantc51e1022010-05-11 19:42:16 +00003511}
3512
3513// find
3514
3515template <class _Traits>
3516struct _LIBCPP_HIDDEN __traits_eq
3517{
3518 typedef typename _Traits::char_type char_type;
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003519 _LIBCPP_INLINE_VISIBILITY
3520 bool operator()(const char_type& __x, const char_type& __y) _NOEXCEPT
3521 {return _Traits::eq(__x, __y);}
Howard Hinnantc51e1022010-05-11 19:42:16 +00003522};
3523
3524template<class _CharT, class _Traits, class _Allocator>
3525typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantd17880b2013-06-28 16:59:19 +00003526basic_string<_CharT, _Traits, _Allocator>::find(const value_type* __s,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003527 size_type __pos,
3528 size_type __n) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003529{
Alp Tokerb8a95f52014-05-15 11:27:39 +00003530 _LIBCPP_ASSERT(__n == 0 || __s != nullptr, "string::find(): received nullptr");
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003531 return __str_find<value_type, size_type, traits_type, npos>
Marshall Clowc527b6e2014-06-02 02:22:49 +00003532 (data(), size(), __s, __pos, __n);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003533}
3534
3535template<class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003536inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00003537typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003538basic_string<_CharT, _Traits, _Allocator>::find(const basic_string& __str,
3539 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003540{
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003541 return __str_find<value_type, size_type, traits_type, npos>
Marshall Clowc527b6e2014-06-02 02:22:49 +00003542 (data(), size(), __str.data(), __pos, __str.size());
Howard Hinnantc51e1022010-05-11 19:42:16 +00003543}
3544
3545template<class _CharT, class _Traits, class _Allocator>
Marshall Clowe46031a2018-07-02 18:41:15 +00003546template <class _Tp>
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003547_EnableIf
Marshall Clowe46031a2018-07-02 18:41:15 +00003548<
3549 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
3550 typename basic_string<_CharT, _Traits, _Allocator>::size_type
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003551>
Marshall Clowe46031a2018-07-02 18:41:15 +00003552basic_string<_CharT, _Traits, _Allocator>::find(const _Tp &__t,
zoecarver1997e0a2021-02-05 11:54:47 -08003553 size_type __pos) const _NOEXCEPT
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003554{
Marshall Clowe46031a2018-07-02 18:41:15 +00003555 __self_view __sv = __t;
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003556 return __str_find<value_type, size_type, traits_type, npos>
3557 (data(), size(), __sv.data(), __pos, __sv.size());
3558}
3559
3560template<class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003561inline
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003562typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantd17880b2013-06-28 16:59:19 +00003563basic_string<_CharT, _Traits, _Allocator>::find(const value_type* __s,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003564 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003565{
Alp Tokerb8a95f52014-05-15 11:27:39 +00003566 _LIBCPP_ASSERT(__s != nullptr, "string::find(): received nullptr");
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003567 return __str_find<value_type, size_type, traits_type, npos>
Marshall Clowc527b6e2014-06-02 02:22:49 +00003568 (data(), size(), __s, __pos, traits_type::length(__s));
Howard Hinnantc51e1022010-05-11 19:42:16 +00003569}
3570
3571template<class _CharT, class _Traits, class _Allocator>
3572typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003573basic_string<_CharT, _Traits, _Allocator>::find(value_type __c,
3574 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003575{
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003576 return __str_find<value_type, size_type, traits_type, npos>
Marshall Clowc527b6e2014-06-02 02:22:49 +00003577 (data(), size(), __c, __pos);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003578}
3579
3580// rfind
3581
3582template<class _CharT, class _Traits, class _Allocator>
3583typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantd17880b2013-06-28 16:59:19 +00003584basic_string<_CharT, _Traits, _Allocator>::rfind(const value_type* __s,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003585 size_type __pos,
3586 size_type __n) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003587{
Alp Tokerb8a95f52014-05-15 11:27:39 +00003588 _LIBCPP_ASSERT(__n == 0 || __s != nullptr, "string::rfind(): received nullptr");
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003589 return __str_rfind<value_type, size_type, traits_type, npos>
Marshall Clowc527b6e2014-06-02 02:22:49 +00003590 (data(), size(), __s, __pos, __n);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003591}
3592
3593template<class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003594inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00003595typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003596basic_string<_CharT, _Traits, _Allocator>::rfind(const basic_string& __str,
3597 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003598{
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003599 return __str_rfind<value_type, size_type, traits_type, npos>
Marshall Clowc527b6e2014-06-02 02:22:49 +00003600 (data(), size(), __str.data(), __pos, __str.size());
Howard Hinnantc51e1022010-05-11 19:42:16 +00003601}
3602
3603template<class _CharT, class _Traits, class _Allocator>
Marshall Clowe46031a2018-07-02 18:41:15 +00003604template <class _Tp>
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003605_EnableIf
Marshall Clowe46031a2018-07-02 18:41:15 +00003606<
3607 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
3608 typename basic_string<_CharT, _Traits, _Allocator>::size_type
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003609>
Marshall Clowe46031a2018-07-02 18:41:15 +00003610basic_string<_CharT, _Traits, _Allocator>::rfind(const _Tp& __t,
zoecarver1997e0a2021-02-05 11:54:47 -08003611 size_type __pos) const _NOEXCEPT
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003612{
Marshall Clowe46031a2018-07-02 18:41:15 +00003613 __self_view __sv = __t;
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003614 return __str_rfind<value_type, size_type, traits_type, npos>
3615 (data(), size(), __sv.data(), __pos, __sv.size());
3616}
3617
3618template<class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003619inline
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003620typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantd17880b2013-06-28 16:59:19 +00003621basic_string<_CharT, _Traits, _Allocator>::rfind(const value_type* __s,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003622 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003623{
Alp Tokerb8a95f52014-05-15 11:27:39 +00003624 _LIBCPP_ASSERT(__s != nullptr, "string::rfind(): received nullptr");
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003625 return __str_rfind<value_type, size_type, traits_type, npos>
Marshall Clowc527b6e2014-06-02 02:22:49 +00003626 (data(), size(), __s, __pos, traits_type::length(__s));
Howard Hinnantc51e1022010-05-11 19:42:16 +00003627}
3628
3629template<class _CharT, class _Traits, class _Allocator>
3630typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003631basic_string<_CharT, _Traits, _Allocator>::rfind(value_type __c,
3632 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003633{
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003634 return __str_rfind<value_type, size_type, traits_type, npos>
Marshall Clowc527b6e2014-06-02 02:22:49 +00003635 (data(), size(), __c, __pos);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003636}
3637
3638// find_first_of
3639
3640template<class _CharT, class _Traits, class _Allocator>
3641typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantd17880b2013-06-28 16:59:19 +00003642basic_string<_CharT, _Traits, _Allocator>::find_first_of(const value_type* __s,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003643 size_type __pos,
3644 size_type __n) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003645{
Alp Tokerb8a95f52014-05-15 11:27:39 +00003646 _LIBCPP_ASSERT(__n == 0 || __s != nullptr, "string::find_first_of(): received nullptr");
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003647 return __str_find_first_of<value_type, size_type, traits_type, npos>
Marshall Clow4bc2be22014-02-16 01:57:26 +00003648 (data(), size(), __s, __pos, __n);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003649}
3650
3651template<class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003652inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00003653typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003654basic_string<_CharT, _Traits, _Allocator>::find_first_of(const basic_string& __str,
3655 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003656{
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003657 return __str_find_first_of<value_type, size_type, traits_type, npos>
Marshall Clow4bc2be22014-02-16 01:57:26 +00003658 (data(), size(), __str.data(), __pos, __str.size());
Howard Hinnantc51e1022010-05-11 19:42:16 +00003659}
3660
3661template<class _CharT, class _Traits, class _Allocator>
Marshall Clowe46031a2018-07-02 18:41:15 +00003662template <class _Tp>
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003663_EnableIf
Marshall Clowe46031a2018-07-02 18:41:15 +00003664<
3665 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
3666 typename basic_string<_CharT, _Traits, _Allocator>::size_type
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003667>
Marshall Clowe46031a2018-07-02 18:41:15 +00003668basic_string<_CharT, _Traits, _Allocator>::find_first_of(const _Tp& __t,
zoecarver1997e0a2021-02-05 11:54:47 -08003669 size_type __pos) const _NOEXCEPT
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003670{
Marshall Clowe46031a2018-07-02 18:41:15 +00003671 __self_view __sv = __t;
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003672 return __str_find_first_of<value_type, size_type, traits_type, npos>
3673 (data(), size(), __sv.data(), __pos, __sv.size());
3674}
3675
3676template<class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003677inline
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003678typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantd17880b2013-06-28 16:59:19 +00003679basic_string<_CharT, _Traits, _Allocator>::find_first_of(const value_type* __s,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003680 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003681{
Alp Tokerb8a95f52014-05-15 11:27:39 +00003682 _LIBCPP_ASSERT(__s != nullptr, "string::find_first_of(): received nullptr");
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003683 return __str_find_first_of<value_type, size_type, traits_type, npos>
Marshall Clow4bc2be22014-02-16 01:57:26 +00003684 (data(), size(), __s, __pos, traits_type::length(__s));
Howard Hinnantc51e1022010-05-11 19:42:16 +00003685}
3686
3687template<class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003688inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00003689typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003690basic_string<_CharT, _Traits, _Allocator>::find_first_of(value_type __c,
3691 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003692{
3693 return find(__c, __pos);
3694}
3695
3696// find_last_of
3697
3698template<class _CharT, class _Traits, class _Allocator>
3699typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantd17880b2013-06-28 16:59:19 +00003700basic_string<_CharT, _Traits, _Allocator>::find_last_of(const value_type* __s,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003701 size_type __pos,
3702 size_type __n) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003703{
Alp Tokerb8a95f52014-05-15 11:27:39 +00003704 _LIBCPP_ASSERT(__n == 0 || __s != nullptr, "string::find_last_of(): received nullptr");
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003705 return __str_find_last_of<value_type, size_type, traits_type, npos>
Marshall Clow4bc2be22014-02-16 01:57:26 +00003706 (data(), size(), __s, __pos, __n);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003707}
3708
3709template<class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003710inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00003711typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003712basic_string<_CharT, _Traits, _Allocator>::find_last_of(const basic_string& __str,
3713 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003714{
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003715 return __str_find_last_of<value_type, size_type, traits_type, npos>
Marshall Clow4bc2be22014-02-16 01:57:26 +00003716 (data(), size(), __str.data(), __pos, __str.size());
Howard Hinnantc51e1022010-05-11 19:42:16 +00003717}
3718
3719template<class _CharT, class _Traits, class _Allocator>
Marshall Clowe46031a2018-07-02 18:41:15 +00003720template <class _Tp>
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003721_EnableIf
Marshall Clowe46031a2018-07-02 18:41:15 +00003722<
3723 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
3724 typename basic_string<_CharT, _Traits, _Allocator>::size_type
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003725>
Marshall Clowe46031a2018-07-02 18:41:15 +00003726basic_string<_CharT, _Traits, _Allocator>::find_last_of(const _Tp& __t,
zoecarver1997e0a2021-02-05 11:54:47 -08003727 size_type __pos) const _NOEXCEPT
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003728{
Marshall Clowe46031a2018-07-02 18:41:15 +00003729 __self_view __sv = __t;
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003730 return __str_find_last_of<value_type, size_type, traits_type, npos>
3731 (data(), size(), __sv.data(), __pos, __sv.size());
3732}
3733
3734template<class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003735inline
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003736typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantd17880b2013-06-28 16:59:19 +00003737basic_string<_CharT, _Traits, _Allocator>::find_last_of(const value_type* __s,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003738 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003739{
Alp Tokerb8a95f52014-05-15 11:27:39 +00003740 _LIBCPP_ASSERT(__s != nullptr, "string::find_last_of(): received nullptr");
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003741 return __str_find_last_of<value_type, size_type, traits_type, npos>
Marshall Clow4bc2be22014-02-16 01:57:26 +00003742 (data(), size(), __s, __pos, traits_type::length(__s));
Howard Hinnantc51e1022010-05-11 19:42:16 +00003743}
3744
3745template<class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003746inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00003747typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003748basic_string<_CharT, _Traits, _Allocator>::find_last_of(value_type __c,
3749 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003750{
3751 return rfind(__c, __pos);
3752}
3753
3754// find_first_not_of
3755
3756template<class _CharT, class _Traits, class _Allocator>
3757typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantd17880b2013-06-28 16:59:19 +00003758basic_string<_CharT, _Traits, _Allocator>::find_first_not_of(const value_type* __s,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003759 size_type __pos,
3760 size_type __n) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003761{
Alp Tokerb8a95f52014-05-15 11:27:39 +00003762 _LIBCPP_ASSERT(__n == 0 || __s != nullptr, "string::find_first_not_of(): received nullptr");
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003763 return __str_find_first_not_of<value_type, size_type, traits_type, npos>
Marshall Clow4bc2be22014-02-16 01:57:26 +00003764 (data(), size(), __s, __pos, __n);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003765}
3766
3767template<class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003768inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00003769typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003770basic_string<_CharT, _Traits, _Allocator>::find_first_not_of(const basic_string& __str,
3771 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003772{
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003773 return __str_find_first_not_of<value_type, size_type, traits_type, npos>
Marshall Clow4bc2be22014-02-16 01:57:26 +00003774 (data(), size(), __str.data(), __pos, __str.size());
Howard Hinnantc51e1022010-05-11 19:42:16 +00003775}
3776
3777template<class _CharT, class _Traits, class _Allocator>
Marshall Clowe46031a2018-07-02 18:41:15 +00003778template <class _Tp>
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003779_EnableIf
Marshall Clowe46031a2018-07-02 18:41:15 +00003780<
3781 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
3782 typename basic_string<_CharT, _Traits, _Allocator>::size_type
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003783>
Marshall Clowe46031a2018-07-02 18:41:15 +00003784basic_string<_CharT, _Traits, _Allocator>::find_first_not_of(const _Tp& __t,
zoecarver1997e0a2021-02-05 11:54:47 -08003785 size_type __pos) const _NOEXCEPT
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003786{
Marshall Clowe46031a2018-07-02 18:41:15 +00003787 __self_view __sv = __t;
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003788 return __str_find_first_not_of<value_type, size_type, traits_type, npos>
3789 (data(), size(), __sv.data(), __pos, __sv.size());
3790}
3791
3792template<class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003793inline
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003794typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantd17880b2013-06-28 16:59:19 +00003795basic_string<_CharT, _Traits, _Allocator>::find_first_not_of(const value_type* __s,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003796 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003797{
Alp Tokerb8a95f52014-05-15 11:27:39 +00003798 _LIBCPP_ASSERT(__s != nullptr, "string::find_first_not_of(): received nullptr");
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003799 return __str_find_first_not_of<value_type, size_type, traits_type, npos>
Marshall Clow4bc2be22014-02-16 01:57:26 +00003800 (data(), size(), __s, __pos, traits_type::length(__s));
Howard Hinnantc51e1022010-05-11 19:42:16 +00003801}
3802
3803template<class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003804inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00003805typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003806basic_string<_CharT, _Traits, _Allocator>::find_first_not_of(value_type __c,
3807 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003808{
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003809 return __str_find_first_not_of<value_type, size_type, traits_type, npos>
Marshall Clow4bc2be22014-02-16 01:57:26 +00003810 (data(), size(), __c, __pos);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003811}
3812
3813// find_last_not_of
3814
3815template<class _CharT, class _Traits, class _Allocator>
3816typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantd17880b2013-06-28 16:59:19 +00003817basic_string<_CharT, _Traits, _Allocator>::find_last_not_of(const value_type* __s,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003818 size_type __pos,
3819 size_type __n) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003820{
Alp Tokerb8a95f52014-05-15 11:27:39 +00003821 _LIBCPP_ASSERT(__n == 0 || __s != nullptr, "string::find_last_not_of(): received nullptr");
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003822 return __str_find_last_not_of<value_type, size_type, traits_type, npos>
Marshall Clow4bc2be22014-02-16 01:57:26 +00003823 (data(), size(), __s, __pos, __n);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003824}
3825
3826template<class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003827inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00003828typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003829basic_string<_CharT, _Traits, _Allocator>::find_last_not_of(const basic_string& __str,
3830 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003831{
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003832 return __str_find_last_not_of<value_type, size_type, traits_type, npos>
Marshall Clow4bc2be22014-02-16 01:57:26 +00003833 (data(), size(), __str.data(), __pos, __str.size());
Howard Hinnantc51e1022010-05-11 19:42:16 +00003834}
3835
3836template<class _CharT, class _Traits, class _Allocator>
Marshall Clowe46031a2018-07-02 18:41:15 +00003837template <class _Tp>
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003838_EnableIf
Marshall Clowe46031a2018-07-02 18:41:15 +00003839<
3840 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
3841 typename basic_string<_CharT, _Traits, _Allocator>::size_type
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003842>
Marshall Clowe46031a2018-07-02 18:41:15 +00003843basic_string<_CharT, _Traits, _Allocator>::find_last_not_of(const _Tp& __t,
zoecarver1997e0a2021-02-05 11:54:47 -08003844 size_type __pos) const _NOEXCEPT
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003845{
Marshall Clowe46031a2018-07-02 18:41:15 +00003846 __self_view __sv = __t;
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003847 return __str_find_last_not_of<value_type, size_type, traits_type, npos>
3848 (data(), size(), __sv.data(), __pos, __sv.size());
3849}
3850
3851template<class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003852inline
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003853typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantd17880b2013-06-28 16:59:19 +00003854basic_string<_CharT, _Traits, _Allocator>::find_last_not_of(const value_type* __s,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003855 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003856{
Alp Tokerb8a95f52014-05-15 11:27:39 +00003857 _LIBCPP_ASSERT(__s != nullptr, "string::find_last_not_of(): received nullptr");
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003858 return __str_find_last_not_of<value_type, size_type, traits_type, npos>
Marshall Clow4bc2be22014-02-16 01:57:26 +00003859 (data(), size(), __s, __pos, traits_type::length(__s));
Howard Hinnantc51e1022010-05-11 19:42:16 +00003860}
3861
3862template<class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003863inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00003864typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003865basic_string<_CharT, _Traits, _Allocator>::find_last_not_of(value_type __c,
3866 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003867{
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003868 return __str_find_last_not_of<value_type, size_type, traits_type, npos>
Marshall Clow4bc2be22014-02-16 01:57:26 +00003869 (data(), size(), __c, __pos);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003870}
3871
3872// compare
3873
3874template <class _CharT, class _Traits, class _Allocator>
Marshall Clowe46031a2018-07-02 18:41:15 +00003875template <class _Tp>
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003876_EnableIf
Marshall Clowe46031a2018-07-02 18:41:15 +00003877<
3878 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
3879 int
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003880>
zoecarver1997e0a2021-02-05 11:54:47 -08003881basic_string<_CharT, _Traits, _Allocator>::compare(const _Tp& __t) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003882{
Marshall Clowe46031a2018-07-02 18:41:15 +00003883 __self_view __sv = __t;
Howard Hinnantb0485532011-07-24 21:45:06 +00003884 size_t __lhs_sz = size();
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003885 size_t __rhs_sz = __sv.size();
3886 int __result = traits_type::compare(data(), __sv.data(),
Howard Hinnantb0485532011-07-24 21:45:06 +00003887 _VSTD::min(__lhs_sz, __rhs_sz));
3888 if (__result != 0)
3889 return __result;
3890 if (__lhs_sz < __rhs_sz)
3891 return -1;
3892 if (__lhs_sz > __rhs_sz)
3893 return 1;
3894 return 0;
Howard Hinnantc51e1022010-05-11 19:42:16 +00003895}
3896
3897template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003898inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00003899int
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003900basic_string<_CharT, _Traits, _Allocator>::compare(const basic_string& __str) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003901{
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003902 return compare(__self_view(__str));
Howard Hinnantc51e1022010-05-11 19:42:16 +00003903}
3904
3905template <class _CharT, class _Traits, class _Allocator>
3906int
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003907basic_string<_CharT, _Traits, _Allocator>::compare(size_type __pos1,
3908 size_type __n1,
Howard Hinnantd17880b2013-06-28 16:59:19 +00003909 const value_type* __s,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003910 size_type __n2) const
Howard Hinnantc51e1022010-05-11 19:42:16 +00003911{
Alp Tokerb8a95f52014-05-15 11:27:39 +00003912 _LIBCPP_ASSERT(__n2 == 0 || __s != nullptr, "string::compare(): received nullptr");
Howard Hinnantc51e1022010-05-11 19:42:16 +00003913 size_type __sz = size();
3914 if (__pos1 > __sz || __n2 == npos)
3915 this->__throw_out_of_range();
Howard Hinnantb1ad5a82011-06-30 21:18:19 +00003916 size_type __rlen = _VSTD::min(__n1, __sz - __pos1);
3917 int __r = traits_type::compare(data() + __pos1, __s, _VSTD::min(__rlen, __n2));
Howard Hinnantc51e1022010-05-11 19:42:16 +00003918 if (__r == 0)
3919 {
3920 if (__rlen < __n2)
3921 __r = -1;
3922 else if (__rlen > __n2)
3923 __r = 1;
3924 }
3925 return __r;
3926}
3927
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003928template <class _CharT, class _Traits, class _Allocator>
Marshall Clowe46031a2018-07-02 18:41:15 +00003929template <class _Tp>
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003930_EnableIf
Marshall Clowe46031a2018-07-02 18:41:15 +00003931<
3932 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
3933 int
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003934>
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003935basic_string<_CharT, _Traits, _Allocator>::compare(size_type __pos1,
3936 size_type __n1,
Marshall Clowe46031a2018-07-02 18:41:15 +00003937 const _Tp& __t) const
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003938{
Marshall Clowe46031a2018-07-02 18:41:15 +00003939 __self_view __sv = __t;
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003940 return compare(__pos1, __n1, __sv.data(), __sv.size());
3941}
3942
3943template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00003944inline
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003945int
3946basic_string<_CharT, _Traits, _Allocator>::compare(size_type __pos1,
3947 size_type __n1,
3948 const basic_string& __str) const
3949{
3950 return compare(__pos1, __n1, __str.data(), __str.size());
3951}
3952
3953template <class _CharT, class _Traits, class _Allocator>
Marshall Clow82513342016-09-24 22:45:42 +00003954template <class _Tp>
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003955_EnableIf
Marshall Clow82513342016-09-24 22:45:42 +00003956<
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003957 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value
3958 && !__is_same_uncvref<_Tp, basic_string<_CharT, _Traits, _Allocator> >::value,
Marshall Clowb7db4972017-11-15 20:02:27 +00003959 int
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003960>
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003961basic_string<_CharT, _Traits, _Allocator>::compare(size_type __pos1,
3962 size_type __n1,
Marshall Clow82513342016-09-24 22:45:42 +00003963 const _Tp& __t,
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003964 size_type __pos2,
3965 size_type __n2) const
3966{
Marshall Clow82513342016-09-24 22:45:42 +00003967 __self_view __sv = __t;
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003968 return __self_view(*this).substr(__pos1, __n1).compare(__sv.substr(__pos2, __n2));
3969}
3970
3971template <class _CharT, class _Traits, class _Allocator>
3972int
3973basic_string<_CharT, _Traits, _Allocator>::compare(size_type __pos1,
3974 size_type __n1,
3975 const basic_string& __str,
3976 size_type __pos2,
3977 size_type __n2) const
3978{
3979 return compare(__pos1, __n1, __self_view(__str), __pos2, __n2);
3980}
3981
3982template <class _CharT, class _Traits, class _Allocator>
3983int
3984basic_string<_CharT, _Traits, _Allocator>::compare(const value_type* __s) const _NOEXCEPT
3985{
3986 _LIBCPP_ASSERT(__s != nullptr, "string::compare(): received nullptr");
3987 return compare(0, npos, __s, traits_type::length(__s));
3988}
3989
3990template <class _CharT, class _Traits, class _Allocator>
3991int
3992basic_string<_CharT, _Traits, _Allocator>::compare(size_type __pos1,
3993 size_type __n1,
3994 const value_type* __s) const
3995{
3996 _LIBCPP_ASSERT(__s != nullptr, "string::compare(): received nullptr");
3997 return compare(__pos1, __n1, __s, traits_type::length(__s));
3998}
3999
Howard Hinnantc51e1022010-05-11 19:42:16 +00004000// __invariants
4001
4002template<class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00004003inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00004004bool
4005basic_string<_CharT, _Traits, _Allocator>::__invariants() const
4006{
4007 if (size() > capacity())
4008 return false;
4009 if (capacity() < __min_cap - 1)
4010 return false;
Bruce Mitchener170d8972020-11-24 12:53:53 -05004011 if (data() == nullptr)
Howard Hinnantc51e1022010-05-11 19:42:16 +00004012 return false;
Louis Dionne663415f2020-10-05 16:16:13 -04004013 if (data()[size()] != value_type())
Howard Hinnantc51e1022010-05-11 19:42:16 +00004014 return false;
4015 return true;
4016}
4017
Vedant Kumar55e007e2018-03-08 21:15:26 +00004018// __clear_and_shrink
4019
4020template<class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00004021inline
Louis Dionne173f29e2019-05-29 16:01:36 +00004022void
Marshall Clowe60a7182018-05-29 17:04:37 +00004023basic_string<_CharT, _Traits, _Allocator>::__clear_and_shrink() _NOEXCEPT
Vedant Kumar55e007e2018-03-08 21:15:26 +00004024{
4025 clear();
4026 if(__is_long())
4027 {
4028 __alloc_traits::deallocate(__alloc(), __get_long_pointer(), capacity() + 1);
4029 __set_long_cap(0);
4030 __set_short_size(0);
Louis Dionne663415f2020-10-05 16:16:13 -04004031 traits_type::assign(*__get_short_pointer(), value_type());
Vedant Kumar55e007e2018-03-08 21:15:26 +00004032 }
Louis Dionne173f29e2019-05-29 16:01:36 +00004033}
Vedant Kumar55e007e2018-03-08 21:15:26 +00004034
Howard Hinnantc51e1022010-05-11 19:42:16 +00004035// operator==
4036
4037template<class _CharT, class _Traits, class _Allocator>
Howard Hinnantb8a8ca22013-10-04 22:09:00 +00004038inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00004039bool
4040operator==(const basic_string<_CharT, _Traits, _Allocator>& __lhs,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004041 const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004042{
Howard Hinnantaaeb1132013-04-22 23:55:13 +00004043 size_t __lhs_sz = __lhs.size();
4044 return __lhs_sz == __rhs.size() && _Traits::compare(__lhs.data(),
4045 __rhs.data(),
4046 __lhs_sz) == 0;
4047}
4048
4049template<class _Allocator>
Howard Hinnantb8a8ca22013-10-04 22:09:00 +00004050inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnantaaeb1132013-04-22 23:55:13 +00004051bool
4052operator==(const basic_string<char, char_traits<char>, _Allocator>& __lhs,
4053 const basic_string<char, char_traits<char>, _Allocator>& __rhs) _NOEXCEPT
4054{
4055 size_t __lhs_sz = __lhs.size();
4056 if (__lhs_sz != __rhs.size())
4057 return false;
4058 const char* __lp = __lhs.data();
4059 const char* __rp = __rhs.data();
4060 if (__lhs.__is_long())
4061 return char_traits<char>::compare(__lp, __rp, __lhs_sz) == 0;
4062 for (; __lhs_sz != 0; --__lhs_sz, ++__lp, ++__rp)
4063 if (*__lp != *__rp)
4064 return false;
4065 return true;
Howard Hinnantc51e1022010-05-11 19:42:16 +00004066}
4067
4068template<class _CharT, class _Traits, class _Allocator>
Howard Hinnantb8a8ca22013-10-04 22:09:00 +00004069inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00004070bool
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004071operator==(const _CharT* __lhs,
4072 const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004073{
Eric Fiselier0cafa3f2015-08-28 03:02:37 +00004074 typedef basic_string<_CharT, _Traits, _Allocator> _String;
4075 _LIBCPP_ASSERT(__lhs != nullptr, "operator==(char*, basic_string): received nullptr");
4076 size_t __lhs_len = _Traits::length(__lhs);
4077 if (__lhs_len != __rhs.size()) return false;
4078 return __rhs.compare(0, _String::npos, __lhs, __lhs_len) == 0;
Howard Hinnantc51e1022010-05-11 19:42:16 +00004079}
4080
Howard Hinnantc51e1022010-05-11 19:42:16 +00004081template<class _CharT, class _Traits, class _Allocator>
Howard Hinnantb8a8ca22013-10-04 22:09:00 +00004082inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00004083bool
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004084operator==(const basic_string<_CharT,_Traits,_Allocator>& __lhs,
4085 const _CharT* __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004086{
Eric Fiselier0cafa3f2015-08-28 03:02:37 +00004087 typedef basic_string<_CharT, _Traits, _Allocator> _String;
4088 _LIBCPP_ASSERT(__rhs != nullptr, "operator==(basic_string, char*): received nullptr");
4089 size_t __rhs_len = _Traits::length(__rhs);
4090 if (__rhs_len != __lhs.size()) return false;
4091 return __lhs.compare(0, _String::npos, __rhs, __rhs_len) == 0;
Howard Hinnantc51e1022010-05-11 19:42:16 +00004092}
4093
Howard Hinnant3b6579a2010-08-22 00:02:43 +00004094template<class _CharT, class _Traits, class _Allocator>
Howard Hinnantb8a8ca22013-10-04 22:09:00 +00004095inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00004096bool
4097operator!=(const basic_string<_CharT,_Traits,_Allocator>& __lhs,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004098 const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004099{
4100 return !(__lhs == __rhs);
4101}
4102
4103template<class _CharT, class _Traits, class _Allocator>
Howard Hinnantb8a8ca22013-10-04 22:09:00 +00004104inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00004105bool
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004106operator!=(const _CharT* __lhs,
4107 const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004108{
4109 return !(__lhs == __rhs);
4110}
4111
4112template<class _CharT, class _Traits, class _Allocator>
Howard Hinnantb8a8ca22013-10-04 22:09:00 +00004113inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00004114bool
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004115operator!=(const basic_string<_CharT, _Traits, _Allocator>& __lhs,
4116 const _CharT* __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004117{
4118 return !(__lhs == __rhs);
4119}
4120
4121// operator<
4122
4123template<class _CharT, class _Traits, class _Allocator>
Howard Hinnantb8a8ca22013-10-04 22:09:00 +00004124inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00004125bool
4126operator< (const basic_string<_CharT, _Traits, _Allocator>& __lhs,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004127 const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004128{
Howard Hinnanta2660c12011-07-24 15:07:21 +00004129 return __lhs.compare(__rhs) < 0;
Howard Hinnantc51e1022010-05-11 19:42:16 +00004130}
4131
4132template<class _CharT, class _Traits, class _Allocator>
Howard Hinnantb8a8ca22013-10-04 22:09:00 +00004133inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00004134bool
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004135operator< (const basic_string<_CharT, _Traits, _Allocator>& __lhs,
4136 const _CharT* __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004137{
Howard Hinnanta2660c12011-07-24 15:07:21 +00004138 return __lhs.compare(__rhs) < 0;
Howard Hinnantc51e1022010-05-11 19:42:16 +00004139}
4140
4141template<class _CharT, class _Traits, class _Allocator>
Howard Hinnantb8a8ca22013-10-04 22:09:00 +00004142inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00004143bool
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004144operator< (const _CharT* __lhs,
4145 const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004146{
4147 return __rhs.compare(__lhs) > 0;
4148}
4149
Howard Hinnantc51e1022010-05-11 19:42:16 +00004150// operator>
4151
4152template<class _CharT, class _Traits, class _Allocator>
Howard Hinnantb8a8ca22013-10-04 22:09:00 +00004153inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00004154bool
4155operator> (const basic_string<_CharT, _Traits, _Allocator>& __lhs,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004156 const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004157{
4158 return __rhs < __lhs;
4159}
4160
4161template<class _CharT, class _Traits, class _Allocator>
Howard Hinnantb8a8ca22013-10-04 22:09:00 +00004162inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00004163bool
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004164operator> (const basic_string<_CharT, _Traits, _Allocator>& __lhs,
4165 const _CharT* __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004166{
4167 return __rhs < __lhs;
4168}
4169
4170template<class _CharT, class _Traits, class _Allocator>
Howard Hinnantb8a8ca22013-10-04 22:09:00 +00004171inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00004172bool
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004173operator> (const _CharT* __lhs,
4174 const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004175{
4176 return __rhs < __lhs;
4177}
4178
4179// operator<=
4180
4181template<class _CharT, class _Traits, class _Allocator>
Howard Hinnantb8a8ca22013-10-04 22:09:00 +00004182inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00004183bool
4184operator<=(const basic_string<_CharT, _Traits, _Allocator>& __lhs,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004185 const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004186{
4187 return !(__rhs < __lhs);
4188}
4189
4190template<class _CharT, class _Traits, class _Allocator>
Howard Hinnantb8a8ca22013-10-04 22:09:00 +00004191inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00004192bool
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004193operator<=(const basic_string<_CharT, _Traits, _Allocator>& __lhs,
4194 const _CharT* __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004195{
4196 return !(__rhs < __lhs);
4197}
4198
4199template<class _CharT, class _Traits, class _Allocator>
Howard Hinnantb8a8ca22013-10-04 22:09:00 +00004200inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00004201bool
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004202operator<=(const _CharT* __lhs,
4203 const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004204{
4205 return !(__rhs < __lhs);
4206}
4207
4208// operator>=
4209
4210template<class _CharT, class _Traits, class _Allocator>
Howard Hinnantb8a8ca22013-10-04 22:09:00 +00004211inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00004212bool
4213operator>=(const basic_string<_CharT, _Traits, _Allocator>& __lhs,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004214 const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004215{
4216 return !(__lhs < __rhs);
4217}
4218
4219template<class _CharT, class _Traits, class _Allocator>
Howard Hinnantb8a8ca22013-10-04 22:09:00 +00004220inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00004221bool
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004222operator>=(const basic_string<_CharT, _Traits, _Allocator>& __lhs,
4223 const _CharT* __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004224{
4225 return !(__lhs < __rhs);
4226}
4227
4228template<class _CharT, class _Traits, class _Allocator>
Howard Hinnantb8a8ca22013-10-04 22:09:00 +00004229inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00004230bool
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004231operator>=(const _CharT* __lhs,
4232 const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004233{
4234 return !(__lhs < __rhs);
4235}
4236
4237// operator +
4238
4239template<class _CharT, class _Traits, class _Allocator>
4240basic_string<_CharT, _Traits, _Allocator>
4241operator+(const basic_string<_CharT, _Traits, _Allocator>& __lhs,
4242 const basic_string<_CharT, _Traits, _Allocator>& __rhs)
4243{
4244 basic_string<_CharT, _Traits, _Allocator> __r(__lhs.get_allocator());
4245 typename basic_string<_CharT, _Traits, _Allocator>::size_type __lhs_sz = __lhs.size();
4246 typename basic_string<_CharT, _Traits, _Allocator>::size_type __rhs_sz = __rhs.size();
4247 __r.__init(__lhs.data(), __lhs_sz, __lhs_sz + __rhs_sz);
4248 __r.append(__rhs.data(), __rhs_sz);
4249 return __r;
4250}
4251
4252template<class _CharT, class _Traits, class _Allocator>
4253basic_string<_CharT, _Traits, _Allocator>
4254operator+(const _CharT* __lhs , const basic_string<_CharT,_Traits,_Allocator>& __rhs)
4255{
4256 basic_string<_CharT, _Traits, _Allocator> __r(__rhs.get_allocator());
4257 typename basic_string<_CharT, _Traits, _Allocator>::size_type __lhs_sz = _Traits::length(__lhs);
4258 typename basic_string<_CharT, _Traits, _Allocator>::size_type __rhs_sz = __rhs.size();
4259 __r.__init(__lhs, __lhs_sz, __lhs_sz + __rhs_sz);
4260 __r.append(__rhs.data(), __rhs_sz);
4261 return __r;
4262}
4263
4264template<class _CharT, class _Traits, class _Allocator>
4265basic_string<_CharT, _Traits, _Allocator>
4266operator+(_CharT __lhs, const basic_string<_CharT,_Traits,_Allocator>& __rhs)
4267{
4268 basic_string<_CharT, _Traits, _Allocator> __r(__rhs.get_allocator());
4269 typename basic_string<_CharT, _Traits, _Allocator>::size_type __rhs_sz = __rhs.size();
4270 __r.__init(&__lhs, 1, 1 + __rhs_sz);
4271 __r.append(__rhs.data(), __rhs_sz);
4272 return __r;
4273}
4274
4275template<class _CharT, class _Traits, class _Allocator>
Eric Fiselierbea70602018-11-26 22:51:35 +00004276inline
Howard Hinnantc51e1022010-05-11 19:42:16 +00004277basic_string<_CharT, _Traits, _Allocator>
4278operator+(const basic_string<_CharT, _Traits, _Allocator>& __lhs, const _CharT* __rhs)
4279{
4280 basic_string<_CharT, _Traits, _Allocator> __r(__lhs.get_allocator());
4281 typename basic_string<_CharT, _Traits, _Allocator>::size_type __lhs_sz = __lhs.size();
4282 typename basic_string<_CharT, _Traits, _Allocator>::size_type __rhs_sz = _Traits::length(__rhs);
4283 __r.__init(__lhs.data(), __lhs_sz, __lhs_sz + __rhs_sz);
4284 __r.append(__rhs, __rhs_sz);
4285 return __r;
4286}
4287
4288template<class _CharT, class _Traits, class _Allocator>
4289basic_string<_CharT, _Traits, _Allocator>
4290operator+(const basic_string<_CharT, _Traits, _Allocator>& __lhs, _CharT __rhs)
4291{
4292 basic_string<_CharT, _Traits, _Allocator> __r(__lhs.get_allocator());
4293 typename basic_string<_CharT, _Traits, _Allocator>::size_type __lhs_sz = __lhs.size();
4294 __r.__init(__lhs.data(), __lhs_sz, __lhs_sz + 1);
4295 __r.push_back(__rhs);
4296 return __r;
4297}
4298
Eric Fiselierfc92be82017-04-19 00:28:44 +00004299#ifndef _LIBCPP_CXX03_LANG
Howard Hinnantc51e1022010-05-11 19:42:16 +00004300
4301template<class _CharT, class _Traits, class _Allocator>
Howard Hinnantb8a8ca22013-10-04 22:09:00 +00004302inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00004303basic_string<_CharT, _Traits, _Allocator>
4304operator+(basic_string<_CharT, _Traits, _Allocator>&& __lhs, const basic_string<_CharT, _Traits, _Allocator>& __rhs)
4305{
Howard Hinnantb1ad5a82011-06-30 21:18:19 +00004306 return _VSTD::move(__lhs.append(__rhs));
Howard Hinnantc51e1022010-05-11 19:42:16 +00004307}
4308
4309template<class _CharT, class _Traits, class _Allocator>
Howard Hinnantb8a8ca22013-10-04 22:09:00 +00004310inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00004311basic_string<_CharT, _Traits, _Allocator>
4312operator+(const basic_string<_CharT, _Traits, _Allocator>& __lhs, basic_string<_CharT, _Traits, _Allocator>&& __rhs)
4313{
Howard Hinnantb1ad5a82011-06-30 21:18:19 +00004314 return _VSTD::move(__rhs.insert(0, __lhs));
Howard Hinnantc51e1022010-05-11 19:42:16 +00004315}
4316
4317template<class _CharT, class _Traits, class _Allocator>
Howard Hinnantb8a8ca22013-10-04 22:09:00 +00004318inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00004319basic_string<_CharT, _Traits, _Allocator>
4320operator+(basic_string<_CharT, _Traits, _Allocator>&& __lhs, basic_string<_CharT, _Traits, _Allocator>&& __rhs)
4321{
Howard Hinnantb1ad5a82011-06-30 21:18:19 +00004322 return _VSTD::move(__lhs.append(__rhs));
Howard Hinnantc51e1022010-05-11 19:42:16 +00004323}
4324
4325template<class _CharT, class _Traits, class _Allocator>
Howard Hinnantb8a8ca22013-10-04 22:09:00 +00004326inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00004327basic_string<_CharT, _Traits, _Allocator>
4328operator+(const _CharT* __lhs , basic_string<_CharT,_Traits,_Allocator>&& __rhs)
4329{
Howard Hinnantb1ad5a82011-06-30 21:18:19 +00004330 return _VSTD::move(__rhs.insert(0, __lhs));
Howard Hinnantc51e1022010-05-11 19:42:16 +00004331}
4332
4333template<class _CharT, class _Traits, class _Allocator>
Howard Hinnantb8a8ca22013-10-04 22:09:00 +00004334inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00004335basic_string<_CharT, _Traits, _Allocator>
4336operator+(_CharT __lhs, basic_string<_CharT,_Traits,_Allocator>&& __rhs)
4337{
4338 __rhs.insert(__rhs.begin(), __lhs);
Howard Hinnantb1ad5a82011-06-30 21:18:19 +00004339 return _VSTD::move(__rhs);
Howard Hinnantc51e1022010-05-11 19:42:16 +00004340}
4341
4342template<class _CharT, class _Traits, class _Allocator>
Howard Hinnantb8a8ca22013-10-04 22:09:00 +00004343inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00004344basic_string<_CharT, _Traits, _Allocator>
4345operator+(basic_string<_CharT, _Traits, _Allocator>&& __lhs, const _CharT* __rhs)
4346{
Howard Hinnantb1ad5a82011-06-30 21:18:19 +00004347 return _VSTD::move(__lhs.append(__rhs));
Howard Hinnantc51e1022010-05-11 19:42:16 +00004348}
4349
4350template<class _CharT, class _Traits, class _Allocator>
Howard Hinnantb8a8ca22013-10-04 22:09:00 +00004351inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00004352basic_string<_CharT, _Traits, _Allocator>
4353operator+(basic_string<_CharT, _Traits, _Allocator>&& __lhs, _CharT __rhs)
4354{
4355 __lhs.push_back(__rhs);
Howard Hinnantb1ad5a82011-06-30 21:18:19 +00004356 return _VSTD::move(__lhs);
Howard Hinnantc51e1022010-05-11 19:42:16 +00004357}
4358
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04004359#endif // _LIBCPP_CXX03_LANG
Howard Hinnantc51e1022010-05-11 19:42:16 +00004360
4361// swap
4362
4363template<class _CharT, class _Traits, class _Allocator>
Howard Hinnantb8a8ca22013-10-04 22:09:00 +00004364inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnantc51e1022010-05-11 19:42:16 +00004365void
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004366swap(basic_string<_CharT, _Traits, _Allocator>& __lhs,
Howard Hinnant3e276872011-06-03 18:40:47 +00004367 basic_string<_CharT, _Traits, _Allocator>& __rhs)
4368 _NOEXCEPT_(_NOEXCEPT_(__lhs.swap(__rhs)))
Howard Hinnantc51e1022010-05-11 19:42:16 +00004369{
4370 __lhs.swap(__rhs);
4371}
4372
Bruce Mitchener170d8972020-11-24 12:53:53 -05004373_LIBCPP_FUNC_VIS int stoi (const string& __str, size_t* __idx = nullptr, int __base = 10);
4374_LIBCPP_FUNC_VIS long stol (const string& __str, size_t* __idx = nullptr, int __base = 10);
4375_LIBCPP_FUNC_VIS unsigned long stoul (const string& __str, size_t* __idx = nullptr, int __base = 10);
4376_LIBCPP_FUNC_VIS long long stoll (const string& __str, size_t* __idx = nullptr, int __base = 10);
4377_LIBCPP_FUNC_VIS unsigned long long stoull(const string& __str, size_t* __idx = nullptr, int __base = 10);
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +00004378
Bruce Mitchener170d8972020-11-24 12:53:53 -05004379_LIBCPP_FUNC_VIS float stof (const string& __str, size_t* __idx = nullptr);
4380_LIBCPP_FUNC_VIS double stod (const string& __str, size_t* __idx = nullptr);
4381_LIBCPP_FUNC_VIS long double stold(const string& __str, size_t* __idx = nullptr);
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +00004382
Howard Hinnanta37d3cf2013-08-12 18:38:34 +00004383_LIBCPP_FUNC_VIS string to_string(int __val);
4384_LIBCPP_FUNC_VIS string to_string(unsigned __val);
4385_LIBCPP_FUNC_VIS string to_string(long __val);
4386_LIBCPP_FUNC_VIS string to_string(unsigned long __val);
4387_LIBCPP_FUNC_VIS string to_string(long long __val);
4388_LIBCPP_FUNC_VIS string to_string(unsigned long long __val);
4389_LIBCPP_FUNC_VIS string to_string(float __val);
4390_LIBCPP_FUNC_VIS string to_string(double __val);
4391_LIBCPP_FUNC_VIS string to_string(long double __val);
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +00004392
Bruce Mitchener170d8972020-11-24 12:53:53 -05004393_LIBCPP_FUNC_VIS int stoi (const wstring& __str, size_t* __idx = nullptr, int __base = 10);
4394_LIBCPP_FUNC_VIS long stol (const wstring& __str, size_t* __idx = nullptr, int __base = 10);
4395_LIBCPP_FUNC_VIS unsigned long stoul (const wstring& __str, size_t* __idx = nullptr, int __base = 10);
4396_LIBCPP_FUNC_VIS long long stoll (const wstring& __str, size_t* __idx = nullptr, int __base = 10);
4397_LIBCPP_FUNC_VIS unsigned long long stoull(const wstring& __str, size_t* __idx = nullptr, int __base = 10);
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +00004398
Bruce Mitchener170d8972020-11-24 12:53:53 -05004399_LIBCPP_FUNC_VIS float stof (const wstring& __str, size_t* __idx = nullptr);
4400_LIBCPP_FUNC_VIS double stod (const wstring& __str, size_t* __idx = nullptr);
4401_LIBCPP_FUNC_VIS long double stold(const wstring& __str, size_t* __idx = nullptr);
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +00004402
Howard Hinnanta37d3cf2013-08-12 18:38:34 +00004403_LIBCPP_FUNC_VIS wstring to_wstring(int __val);
4404_LIBCPP_FUNC_VIS wstring to_wstring(unsigned __val);
4405_LIBCPP_FUNC_VIS wstring to_wstring(long __val);
4406_LIBCPP_FUNC_VIS wstring to_wstring(unsigned long __val);
4407_LIBCPP_FUNC_VIS wstring to_wstring(long long __val);
4408_LIBCPP_FUNC_VIS wstring to_wstring(unsigned long long __val);
4409_LIBCPP_FUNC_VIS wstring to_wstring(float __val);
4410_LIBCPP_FUNC_VIS wstring to_wstring(double __val);
4411_LIBCPP_FUNC_VIS wstring to_wstring(long double __val);
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +00004412
Howard Hinnantc51e1022010-05-11 19:42:16 +00004413template<class _CharT, class _Traits, class _Allocator>
Martin Storsjö88890c22021-02-22 01:13:13 +02004414_LIBCPP_TEMPLATE_DATA_VIS
Eric Fiselierc9fdaf12020-01-15 17:02:17 -05004415const typename basic_string<_CharT, _Traits, _Allocator>::size_type
4416 basic_string<_CharT, _Traits, _Allocator>::npos;
Howard Hinnantc51e1022010-05-11 19:42:16 +00004417
Marshall Clow851b9ec2019-05-20 21:56:51 +00004418template <class _CharT, class _Allocator>
4419struct _LIBCPP_TEMPLATE_VIS
4420 hash<basic_string<_CharT, char_traits<_CharT>, _Allocator> >
4421 : public unary_function<
4422 basic_string<_CharT, char_traits<_CharT>, _Allocator>, size_t>
Howard Hinnantc51e1022010-05-11 19:42:16 +00004423{
4424 size_t
Marshall Clow851b9ec2019-05-20 21:56:51 +00004425 operator()(const basic_string<_CharT, char_traits<_CharT>, _Allocator>& __val) const _NOEXCEPT
4426 { return __do_string_hash(__val.data(), __val.data() + __val.size()); }
Howard Hinnantc51e1022010-05-11 19:42:16 +00004427};
4428
Howard Hinnantc51e1022010-05-11 19:42:16 +00004429
Howard Hinnantdc095972011-07-18 15:51:59 +00004430template<class _CharT, class _Traits, class _Allocator>
4431basic_ostream<_CharT, _Traits>&
4432operator<<(basic_ostream<_CharT, _Traits>& __os,
4433 const basic_string<_CharT, _Traits, _Allocator>& __str);
4434
4435template<class _CharT, class _Traits, class _Allocator>
4436basic_istream<_CharT, _Traits>&
4437operator>>(basic_istream<_CharT, _Traits>& __is,
4438 basic_string<_CharT, _Traits, _Allocator>& __str);
4439
4440template<class _CharT, class _Traits, class _Allocator>
4441basic_istream<_CharT, _Traits>&
4442getline(basic_istream<_CharT, _Traits>& __is,
4443 basic_string<_CharT, _Traits, _Allocator>& __str, _CharT __dlm);
4444
4445template<class _CharT, class _Traits, class _Allocator>
4446inline _LIBCPP_INLINE_VISIBILITY
4447basic_istream<_CharT, _Traits>&
4448getline(basic_istream<_CharT, _Traits>& __is,
4449 basic_string<_CharT, _Traits, _Allocator>& __str);
4450
Howard Hinnantdc095972011-07-18 15:51:59 +00004451template<class _CharT, class _Traits, class _Allocator>
4452inline _LIBCPP_INLINE_VISIBILITY
4453basic_istream<_CharT, _Traits>&
4454getline(basic_istream<_CharT, _Traits>&& __is,
4455 basic_string<_CharT, _Traits, _Allocator>& __str, _CharT __dlm);
4456
4457template<class _CharT, class _Traits, class _Allocator>
4458inline _LIBCPP_INLINE_VISIBILITY
4459basic_istream<_CharT, _Traits>&
4460getline(basic_istream<_CharT, _Traits>&& __is,
4461 basic_string<_CharT, _Traits, _Allocator>& __str);
4462
Marshall Clow29b53f22018-12-14 18:49:35 +00004463#if _LIBCPP_STD_VER > 17
Marek Kurdeja98b1412020-05-02 13:58:03 +02004464template <class _CharT, class _Traits, class _Allocator, class _Up>
Marshall Clow29b53f22018-12-14 18:49:35 +00004465inline _LIBCPP_INLINE_VISIBILITY
Marek Kurdeja98b1412020-05-02 13:58:03 +02004466 typename basic_string<_CharT, _Traits, _Allocator>::size_type
4467 erase(basic_string<_CharT, _Traits, _Allocator>& __str, const _Up& __v) {
4468 auto __old_size = __str.size();
4469 __str.erase(_VSTD::remove(__str.begin(), __str.end(), __v), __str.end());
4470 return __old_size - __str.size();
4471}
Marshall Clow29b53f22018-12-14 18:49:35 +00004472
Marek Kurdeja98b1412020-05-02 13:58:03 +02004473template <class _CharT, class _Traits, class _Allocator, class _Predicate>
Marshall Clow29b53f22018-12-14 18:49:35 +00004474inline _LIBCPP_INLINE_VISIBILITY
Marek Kurdeja98b1412020-05-02 13:58:03 +02004475 typename basic_string<_CharT, _Traits, _Allocator>::size_type
4476 erase_if(basic_string<_CharT, _Traits, _Allocator>& __str,
4477 _Predicate __pred) {
4478 auto __old_size = __str.size();
4479 __str.erase(_VSTD::remove_if(__str.begin(), __str.end(), __pred),
4480 __str.end());
4481 return __old_size - __str.size();
4482}
Marshall Clow29b53f22018-12-14 18:49:35 +00004483#endif
4484
Louis Dionneba400782020-10-02 15:02:52 -04004485#if _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnant8ea98242013-08-23 17:37:05 +00004486
4487template<class _CharT, class _Traits, class _Allocator>
4488bool
4489basic_string<_CharT, _Traits, _Allocator>::__dereferenceable(const const_iterator* __i) const
4490{
Eric Fiselierc1b87a72019-11-16 17:13:26 -05004491 return this->data() <= _VSTD::__to_address(__i->base()) &&
4492 _VSTD::__to_address(__i->base()) < this->data() + this->size();
Howard Hinnant8ea98242013-08-23 17:37:05 +00004493}
4494
4495template<class _CharT, class _Traits, class _Allocator>
4496bool
4497basic_string<_CharT, _Traits, _Allocator>::__decrementable(const const_iterator* __i) const
4498{
Eric Fiselierc1b87a72019-11-16 17:13:26 -05004499 return this->data() < _VSTD::__to_address(__i->base()) &&
4500 _VSTD::__to_address(__i->base()) <= this->data() + this->size();
Howard Hinnant8ea98242013-08-23 17:37:05 +00004501}
4502
4503template<class _CharT, class _Traits, class _Allocator>
4504bool
4505basic_string<_CharT, _Traits, _Allocator>::__addable(const const_iterator* __i, ptrdiff_t __n) const
4506{
Eric Fiselierc1b87a72019-11-16 17:13:26 -05004507 const value_type* __p = _VSTD::__to_address(__i->base()) + __n;
Howard Hinnant8ea98242013-08-23 17:37:05 +00004508 return this->data() <= __p && __p <= this->data() + this->size();
4509}
4510
4511template<class _CharT, class _Traits, class _Allocator>
4512bool
4513basic_string<_CharT, _Traits, _Allocator>::__subscriptable(const const_iterator* __i, ptrdiff_t __n) const
4514{
Eric Fiselierc1b87a72019-11-16 17:13:26 -05004515 const value_type* __p = _VSTD::__to_address(__i->base()) + __n;
Howard Hinnant8ea98242013-08-23 17:37:05 +00004516 return this->data() <= __p && __p < this->data() + this->size();
4517}
4518
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04004519#endif // _LIBCPP_DEBUG_LEVEL == 2
Howard Hinnant8ea98242013-08-23 17:37:05 +00004520
Louis Dionne173f29e2019-05-29 16:01:36 +00004521#if _LIBCPP_STD_VER > 11
Marshall Clowcba751f2013-07-23 17:05:24 +00004522// Literal suffixes for basic_string [basic.string.literals]
Marshall Clowac868372013-10-05 21:18:32 +00004523inline namespace literals
Marshall Clowcba751f2013-07-23 17:05:24 +00004524{
4525 inline namespace string_literals
4526 {
Howard Hinnant5c167562013-08-07 19:39:48 +00004527 inline _LIBCPP_INLINE_VISIBILITY
4528 basic_string<char> operator "" s( const char *__str, size_t __len )
4529 {
4530 return basic_string<char> (__str, __len);
4531 }
Marshall Clowcba751f2013-07-23 17:05:24 +00004532
Howard Hinnant5c167562013-08-07 19:39:48 +00004533 inline _LIBCPP_INLINE_VISIBILITY
4534 basic_string<wchar_t> operator "" s( const wchar_t *__str, size_t __len )
4535 {
4536 return basic_string<wchar_t> (__str, __len);
4537 }
Marshall Clowcba751f2013-07-23 17:05:24 +00004538
Arthur O'Dwyerafa5d5f2021-04-18 21:47:08 -04004539#ifndef _LIBCPP_HAS_NO_CHAR8_T
Marshall Clow8732fed2018-12-11 04:35:44 +00004540 inline _LIBCPP_INLINE_VISIBILITY
4541 basic_string<char8_t> operator "" s(const char8_t *__str, size_t __len) _NOEXCEPT
4542 {
4543 return basic_string<char8_t> (__str, __len);
4544 }
4545#endif
4546
Howard Hinnant5c167562013-08-07 19:39:48 +00004547 inline _LIBCPP_INLINE_VISIBILITY
4548 basic_string<char16_t> operator "" s( const char16_t *__str, size_t __len )
4549 {
4550 return basic_string<char16_t> (__str, __len);
4551 }
Marshall Clowcba751f2013-07-23 17:05:24 +00004552
Howard Hinnant5c167562013-08-07 19:39:48 +00004553 inline _LIBCPP_INLINE_VISIBILITY
4554 basic_string<char32_t> operator "" s( const char32_t *__str, size_t __len )
4555 {
4556 return basic_string<char32_t> (__str, __len);
4557 }
Marshall Clowcba751f2013-07-23 17:05:24 +00004558 }
4559}
4560#endif
4561
Howard Hinnantc51e1022010-05-11 19:42:16 +00004562_LIBCPP_END_NAMESPACE_STD
4563
Eric Fiselierf4433a32017-05-31 22:07:49 +00004564_LIBCPP_POP_MACROS
4565
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04004566#endif // _LIBCPP_STRING