blob: cb32392d440623a0cbba00bcd31df26e4fcbd334 [file] [log] [blame]
Howard Hinnantc51e1022010-05-11 19:42:16 +00001// -*- C++ -*-
Louis Dionne9bd93882021-11-17 16:25:01 -05002//===----------------------------------------------------------------------===//
Howard Hinnantc51e1022010-05-11 19:42:16 +00003//
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()
Nikolas Klauser80b3cf32022-04-27 10:11:44 +020098 noexcept(is_nothrow_default_constructible<allocator_type>::value); // constexpr since C++20
99 explicit basic_string(const allocator_type& a); // constexpr since C++20
100 basic_string(const basic_string& str); // constexpr since C++20
Howard Hinnant3e276872011-06-03 18:40:47 +0000101 basic_string(basic_string&& str)
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200102 noexcept(is_nothrow_move_constructible<allocator_type>::value); // constexpr since C++20
Marshall Clow83445802016-04-07 18:13:41 +0000103 basic_string(const basic_string& str, size_type pos,
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200104 const allocator_type& a = allocator_type()); // constexpr since C++20
Marshall Clow83445802016-04-07 18:13:41 +0000105 basic_string(const basic_string& str, size_type pos, size_type n,
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200106 const Allocator& a = Allocator()); // constexpr since C++20
Marshall Clow78dbe462016-11-14 18:22:19 +0000107 template<class T>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200108 basic_string(const T& t, size_type pos, size_type n, const Allocator& a = Allocator()); // C++17, constexpr since C++20
Marshall Clowe46031a2018-07-02 18:41:15 +0000109 template <class T>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200110 explicit basic_string(const T& t, const Allocator& a = Allocator()); // C++17, constexpr since C++20
111 basic_string(const value_type* s, const allocator_type& a = allocator_type()); // constexpr since C++20
112 basic_string(const value_type* s, size_type n, const allocator_type& a = allocator_type()); // constexpr since C++20
Marek Kurdej90d79712021-07-27 16:16:21 +0200113 basic_string(nullptr_t) = delete; // C++2b
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200114 basic_string(size_type n, value_type c, const allocator_type& a = allocator_type()); // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000115 template<class InputIterator>
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000116 basic_string(InputIterator begin, InputIterator end,
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200117 const allocator_type& a = allocator_type()); // constexpr since C++20
118 basic_string(initializer_list<value_type>, const Allocator& = Allocator()); // constexpr since C++20
119 basic_string(const basic_string&, const Allocator&); // constexpr since C++20
120 basic_string(basic_string&&, const Allocator&); // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000121
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200122 ~basic_string(); // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000123
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200124 operator basic_string_view<charT, traits>() const noexcept; // constexpr since C++20
Marshall Clowdf63a6d2016-07-21 05:31:24 +0000125
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200126 basic_string& operator=(const basic_string& str); // constexpr since C++20
Marshall Clowe46031a2018-07-02 18:41:15 +0000127 template <class T>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200128 basic_string& operator=(const T& t); // C++17, constexpr since C++20
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 ||
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200132 allocator_type::is_always_equal::value ); // C++17, constexpr since C++20
133 basic_string& operator=(const value_type* s); // constexpr since C++20
Marek Kurdej90d79712021-07-27 16:16:21 +0200134 basic_string& operator=(nullptr_t) = delete; // C++2b
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200135 basic_string& operator=(value_type c); // constexpr since C++20
136 basic_string& operator=(initializer_list<value_type>); // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000137
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200138 iterator begin() noexcept; // constexpr since C++20
139 const_iterator begin() const noexcept; // constexpr since C++20
140 iterator end() noexcept; // constexpr since C++20
141 const_iterator end() const noexcept; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000142
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200143 reverse_iterator rbegin() noexcept; // constexpr since C++20
144 const_reverse_iterator rbegin() const noexcept; // constexpr since C++20
145 reverse_iterator rend() noexcept; // constexpr since C++20
146 const_reverse_iterator rend() const noexcept; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000147
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200148 const_iterator cbegin() const noexcept; // constexpr since C++20
149 const_iterator cend() const noexcept; // constexpr since C++20
150 const_reverse_iterator crbegin() const noexcept; // constexpr since C++20
151 const_reverse_iterator crend() const noexcept; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000152
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200153 size_type size() const noexcept; // constexpr since C++20
154 size_type length() const noexcept; // constexpr since C++20
155 size_type max_size() const noexcept; // constexpr since C++20
156 size_type capacity() const noexcept; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000157
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200158 void resize(size_type n, value_type c); // constexpr since C++20
159 void resize(size_type n); // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000160
Nikolas Klauser9e6040c2022-01-06 21:43:26 +0100161 template<class Operation>
162 constexpr void resize_and_overwrite(size_type n, Operation op); // since C++23
163
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200164 void reserve(size_type res_arg); // constexpr since C++20
Marek Kurdejc9848142020-11-26 10:07:16 +0100165 void reserve(); // deprecated in C++20
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200166 void shrink_to_fit(); // constexpr since C++20
167 void clear() noexcept; // constexpr since C++20
168 bool empty() const noexcept; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000169
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200170 const_reference operator[](size_type pos) const; // constexpr since C++20
171 reference operator[](size_type pos); // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000172
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200173 const_reference at(size_type n) const; // constexpr since C++20
174 reference at(size_type n); // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000175
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200176 basic_string& operator+=(const basic_string& str); // constexpr since C++20
Marshall Clowe46031a2018-07-02 18:41:15 +0000177 template <class T>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200178 basic_string& operator+=(const T& t); // C++17, constexpr since C++20
179 basic_string& operator+=(const value_type* s); // constexpr since C++20
180 basic_string& operator+=(value_type c); // constexpr since C++20
181 basic_string& operator+=(initializer_list<value_type>); // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000182
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200183 basic_string& append(const basic_string& str); // constexpr since C++20
Marshall Clowe46031a2018-07-02 18:41:15 +0000184 template <class T>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200185 basic_string& append(const T& t); // C++17, constexpr since C++20
186 basic_string& append(const basic_string& str, size_type pos, size_type n=npos); // C++14, constexpr since C++20
Marshall Clow82513342016-09-24 22:45:42 +0000187 template <class T>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200188 basic_string& append(const T& t, size_type pos, size_type n=npos); // C++17, constexpr since C++20
189 basic_string& append(const value_type* s, size_type n); // constexpr since C++20
190 basic_string& append(const value_type* s); // constexpr since C++20
191 basic_string& append(size_type n, value_type c); // constexpr since C++20
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000192 template<class InputIterator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200193 basic_string& append(InputIterator first, InputIterator last); // constexpr since C++20
194 basic_string& append(initializer_list<value_type>); // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000195
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200196 void push_back(value_type c); // constexpr since C++20
197 void pop_back(); // constexpr since C++20
198 reference front(); // constexpr since C++20
199 const_reference front() const; // constexpr since C++20
200 reference back(); // constexpr since C++20
201 const_reference back() const; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000202
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200203 basic_string& assign(const basic_string& str); // constexpr since C++20
Marshall Clowe46031a2018-07-02 18:41:15 +0000204 template <class T>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200205 basic_string& assign(const T& t); // C++17, constexpr since C++20
206 basic_string& assign(basic_string&& str); // constexpr since C++20
207 basic_string& assign(const basic_string& str, size_type pos, size_type n=npos); // C++14, constexpr since C++20
Marshall Clow82513342016-09-24 22:45:42 +0000208 template <class T>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200209 basic_string& assign(const T& t, size_type pos, size_type n=npos); // C++17, constexpr since C++20
210 basic_string& assign(const value_type* s, size_type n); // constexpr since C++20
211 basic_string& assign(const value_type* s); // constexpr since C++20
212 basic_string& assign(size_type n, value_type c); // constexpr since C++20
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000213 template<class InputIterator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200214 basic_string& assign(InputIterator first, InputIterator last); // constexpr since C++20
215 basic_string& assign(initializer_list<value_type>); // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000216
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200217 basic_string& insert(size_type pos1, const basic_string& str); // constexpr since C++20
Marshall Clowe46031a2018-07-02 18:41:15 +0000218 template <class T>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200219 basic_string& insert(size_type pos1, const T& t); // constexpr since C++20
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000220 basic_string& insert(size_type pos1, const basic_string& str,
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200221 size_type pos2, size_type n); // constexpr since C++20
Marshall Clow82513342016-09-24 22:45:42 +0000222 template <class T>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200223 basic_string& insert(size_type pos1, const T& t, size_type pos2, size_type n); // C++17, constexpr since C++20
224 basic_string& insert(size_type pos, const value_type* s, size_type n=npos); // C++14, constexpr since C++20
225 basic_string& insert(size_type pos, const value_type* s); // constexpr since C++20
226 basic_string& insert(size_type pos, size_type n, value_type c); // constexpr since C++20
227 iterator insert(const_iterator p, value_type c); // constexpr since C++20
228 iterator insert(const_iterator p, size_type n, value_type c); // constexpr since C++20
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000229 template<class InputIterator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200230 iterator insert(const_iterator p, InputIterator first, InputIterator last); // constexpr since C++20
231 iterator insert(const_iterator p, initializer_list<value_type>); // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000232
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200233 basic_string& erase(size_type pos = 0, size_type n = npos); // constexpr since C++20
234 iterator erase(const_iterator position); // constexpr since C++20
235 iterator erase(const_iterator first, const_iterator last); // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000236
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200237 basic_string& replace(size_type pos1, size_type n1, const basic_string& str); // constexpr since C++20
Marshall Clowe46031a2018-07-02 18:41:15 +0000238 template <class T>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200239 basic_string& replace(size_type pos1, size_type n1, const T& t); // C++17, constexpr since C++20
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000240 basic_string& replace(size_type pos1, size_type n1, const basic_string& str,
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200241 size_type pos2, size_type n2=npos); // C++14, constexpr since C++20
Marshall Clow82513342016-09-24 22:45:42 +0000242 template <class T>
243 basic_string& replace(size_type pos1, size_type n1, const T& t,
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200244 size_type pos2, size_type n); // C++17, constexpr since C++20
245 basic_string& replace(size_type pos, size_type n1, const value_type* s, size_type n2); // constexpr since C++20
246 basic_string& replace(size_type pos, size_type n1, const value_type* s); // constexpr since C++20
247 basic_string& replace(size_type pos, size_type n1, size_type n2, value_type c); // constexpr since C++20
248 basic_string& replace(const_iterator i1, const_iterator i2, const basic_string& str); // constexpr since C++20
Marshall Clowe46031a2018-07-02 18:41:15 +0000249 template <class T>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200250 basic_string& replace(const_iterator i1, const_iterator i2, const T& t); // C++17, constexpr since C++20
251 basic_string& replace(const_iterator i1, const_iterator i2, const value_type* s, size_type n); // constexpr since C++20
252 basic_string& replace(const_iterator i1, const_iterator i2, const value_type* s); // constexpr since C++20
253 basic_string& replace(const_iterator i1, const_iterator i2, size_type n, value_type c); // constexpr since C++20
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000254 template<class InputIterator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200255 basic_string& replace(const_iterator i1, const_iterator i2, InputIterator j1, InputIterator j2); // constexpr since C++20
256 basic_string& replace(const_iterator i1, const_iterator i2, initializer_list<value_type>); // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000257
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200258 size_type copy(value_type* s, size_type n, size_type pos = 0) const; // constexpr since C++20
259 basic_string substr(size_type pos = 0, size_type n = npos) const; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000260
Howard Hinnant3e276872011-06-03 18:40:47 +0000261 void swap(basic_string& str)
Marshall Clow8982dcd2015-07-13 20:04:56 +0000262 noexcept(allocator_traits<allocator_type>::propagate_on_container_swap::value ||
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200263 allocator_traits<allocator_type>::is_always_equal::value); // C++17, constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000264
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200265 const value_type* c_str() const noexcept; // constexpr since C++20
266 const value_type* data() const noexcept; // constexpr since C++20
267 value_type* data() noexcept; // C++17, constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000268
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200269 allocator_type get_allocator() const noexcept; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000270
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200271 size_type find(const basic_string& str, size_type pos = 0) const noexcept; // constexpr since C++20
Marshall Clowe46031a2018-07-02 18:41:15 +0000272 template <class T>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200273 size_type find(const T& t, size_type pos = 0) const noexcept; // C++17, noexcept as an extension, constexpr since C++20
274 size_type find(const value_type* s, size_type pos, size_type n) const noexcept; // constexpr since C++20
275 size_type find(const value_type* s, size_type pos = 0) const noexcept; // constexpr since C++20
276 size_type find(value_type c, size_type pos = 0) const noexcept; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000277
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200278 size_type rfind(const basic_string& str, size_type pos = npos) const noexcept; // constexpr since C++20
Marshall Clowe46031a2018-07-02 18:41:15 +0000279 template <class T>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200280 size_type rfind(const T& t, size_type pos = npos) const noexcept; // C++17, noexcept as an extension, constexpr since C++20
281 size_type rfind(const value_type* s, size_type pos, size_type n) const noexcept; // constexpr since C++20
282 size_type rfind(const value_type* s, size_type pos = npos) const noexcept; // constexpr since C++20
283 size_type rfind(value_type c, size_type pos = npos) const noexcept; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000284
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200285 size_type find_first_of(const basic_string& str, size_type pos = 0) const noexcept; // constexpr since C++20
Marshall Clowe46031a2018-07-02 18:41:15 +0000286 template <class T>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200287 size_type find_first_of(const T& t, size_type pos = 0) const noexcept; // C++17, noexcept as an extension, constexpr since C++20
288 size_type find_first_of(const value_type* s, size_type pos, size_type n) const noexcept; // constexpr since C++20
289 size_type find_first_of(const value_type* s, size_type pos = 0) const noexcept; // constexpr since C++20
290 size_type find_first_of(value_type c, size_type pos = 0) const noexcept; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000291
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200292 size_type find_last_of(const basic_string& str, size_type pos = npos) const noexcept; // constexpr since C++20
Marshall Clowe46031a2018-07-02 18:41:15 +0000293 template <class T>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200294 size_type find_last_of(const T& t, size_type pos = npos) const noexcept noexcept; // C++17, noexcept as an extension, constexpr since C++20
295 size_type find_last_of(const value_type* s, size_type pos, size_type n) const noexcept; // constexpr since C++20
296 size_type find_last_of(const value_type* s, size_type pos = npos) const noexcept; // constexpr since C++20
297 size_type find_last_of(value_type c, size_type pos = npos) const noexcept; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000298
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200299 size_type find_first_not_of(const basic_string& str, size_type pos = 0) const noexcept; // constexpr since C++20
Marshall Clowe46031a2018-07-02 18:41:15 +0000300 template <class T>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200301 size_type find_first_not_of(const T& t, size_type pos = 0) const noexcept; // C++17, noexcept as an extension, constexpr since C++20
302 size_type find_first_not_of(const value_type* s, size_type pos, size_type n) const noexcept; // constexpr since C++20
303 size_type find_first_not_of(const value_type* s, size_type pos = 0) const noexcept; // constexpr since C++20
304 size_type find_first_not_of(value_type c, size_type pos = 0) const noexcept; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000305
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200306 size_type find_last_not_of(const basic_string& str, size_type pos = npos) const noexcept; // constexpr since C++20
Marshall Clowe46031a2018-07-02 18:41:15 +0000307 template <class T>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200308 size_type find_last_not_of(const T& t, size_type pos = npos) const noexcept; // C++17, noexcept as an extension, constexpr since C++20
309 size_type find_last_not_of(const value_type* s, size_type pos, size_type n) const noexcept; // constexpr since C++20
310 size_type find_last_not_of(const value_type* s, size_type pos = npos) const noexcept; // constexpr since C++20
311 size_type find_last_not_of(value_type c, size_type pos = npos) const noexcept; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000312
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200313 int compare(const basic_string& str) const noexcept; // constexpr since C++20
Marshall Clowe46031a2018-07-02 18:41:15 +0000314 template <class T>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200315 int compare(const T& t) const noexcept; // C++17, noexcept as an extension, constexpr since C++20
316 int compare(size_type pos1, size_type n1, const basic_string& str) const; // constexpr since C++20
Marshall Clowe46031a2018-07-02 18:41:15 +0000317 template <class T>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200318 int compare(size_type pos1, size_type n1, const T& t) const; // C++17, constexpr since C++20
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000319 int compare(size_type pos1, size_type n1, const basic_string& str,
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200320 size_type pos2, size_type n2=npos) const; // C++14, constexpr since C++20
Marshall Clow82513342016-09-24 22:45:42 +0000321 template <class T>
322 int compare(size_type pos1, size_type n1, const T& t,
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200323 size_type pos2, size_type n2=npos) const; // C++17, constexpr since C++20
324 int compare(const value_type* s) const noexcept; // constexpr since C++20
325 int compare(size_type pos1, size_type n1, const value_type* s) const; // constexpr since C++20
326 int compare(size_type pos1, size_type n1, const value_type* s, size_type n2) const; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000327
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200328 constexpr bool starts_with(basic_string_view<charT, traits> sv) const noexcept; // C++20
329 constexpr bool starts_with(charT c) const noexcept; // C++20
330 constexpr bool starts_with(const charT* s) const; // C++20
331 constexpr bool ends_with(basic_string_view<charT, traits> sv) const noexcept; // C++20
332 constexpr bool ends_with(charT c) const noexcept; // C++20
333 constexpr bool ends_with(const charT* s) const; // C++20
Marshall Clow18c293b2017-12-04 20:11:38 +0000334
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200335 constexpr bool contains(basic_string_view<charT, traits> sv) const noexcept; // C++2b
336 constexpr bool contains(charT c) const noexcept; // C++2b
337 constexpr bool contains(const charT* s) const; // C++2b
Howard Hinnantc51e1022010-05-11 19:42:16 +0000338};
339
Marshall Clowa0563332018-02-08 06:34:03 +0000340template<class InputIterator,
341 class Allocator = allocator<typename iterator_traits<InputIterator>::value_type>>
342basic_string(InputIterator, InputIterator, Allocator = Allocator())
343 -> basic_string<typename iterator_traits<InputIterator>::value_type,
344 char_traits<typename iterator_traits<InputIterator>::value_type>,
345 Allocator>; // C++17
346
Howard Hinnantc51e1022010-05-11 19:42:16 +0000347template<class charT, class traits, class Allocator>
348basic_string<charT, traits, Allocator>
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000349operator+(const basic_string<charT, traits, Allocator>& lhs,
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200350 const basic_string<charT, traits, Allocator>& rhs); // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000351
352template<class charT, class traits, class Allocator>
353basic_string<charT, traits, Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200354operator+(const charT* lhs , const basic_string<charT,traits,Allocator>&rhs); // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000355
356template<class charT, class traits, class Allocator>
357basic_string<charT, traits, Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200358operator+(charT lhs, const basic_string<charT,traits,Allocator>& rhs); // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000359
360template<class charT, class traits, class Allocator>
361basic_string<charT, traits, Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200362operator+(const basic_string<charT, traits, Allocator>& lhs, const charT* rhs); // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000363
364template<class charT, class traits, class Allocator>
365basic_string<charT, traits, Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200366operator+(const basic_string<charT, traits, Allocator>& lhs, charT rhs); // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000367
368template<class charT, class traits, class Allocator>
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000369bool operator==(const basic_string<charT, traits, Allocator>& lhs,
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200370 const basic_string<charT, traits, Allocator>& rhs) noexcept; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000371
372template<class charT, class traits, class Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200373bool operator==(const charT* lhs, const basic_string<charT, traits, Allocator>& rhs) noexcept; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000374
375template<class charT, class traits, class Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200376bool operator==(const basic_string<charT,traits,Allocator>& lhs, const charT* rhs) noexcept; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000377
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000378template<class charT, class traits, class Allocator>
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000379bool operator!=(const basic_string<charT,traits,Allocator>& lhs,
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200380 const basic_string<charT, traits, Allocator>& rhs) noexcept; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000381
382template<class charT, class traits, class Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200383bool operator!=(const charT* lhs, const basic_string<charT, traits, Allocator>& rhs) noexcept; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000384
385template<class charT, class traits, class Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200386bool operator!=(const basic_string<charT, traits, Allocator>& lhs, const charT* rhs) noexcept; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000387
388template<class charT, class traits, class Allocator>
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000389bool operator< (const basic_string<charT, traits, Allocator>& lhs,
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200390 const basic_string<charT, traits, Allocator>& rhs) noexcept; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000391
392template<class charT, class traits, class Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200393bool operator< (const basic_string<charT, traits, Allocator>& lhs, const charT* rhs) noexcept; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000394
395template<class charT, class traits, class Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200396bool operator< (const charT* lhs, const basic_string<charT, traits, Allocator>& rhs) noexcept; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000397
398template<class charT, class traits, class Allocator>
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000399bool operator> (const basic_string<charT, traits, Allocator>& lhs,
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200400 const basic_string<charT, traits, Allocator>& rhs) noexcept; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000401
402template<class charT, class traits, class Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200403bool operator> (const basic_string<charT, traits, Allocator>& lhs, const charT* rhs) noexcept; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000404
405template<class charT, class traits, class Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200406bool operator> (const charT* lhs, const basic_string<charT, traits, Allocator>& rhs) noexcept; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000407
408template<class charT, class traits, class Allocator>
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000409bool operator<=(const basic_string<charT, traits, Allocator>& lhs,
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200410 const basic_string<charT, traits, Allocator>& rhs) noexcept; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000411
412template<class charT, class traits, class Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200413bool operator<=(const basic_string<charT, traits, Allocator>& lhs, const charT* rhs) noexcept; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000414
415template<class charT, class traits, class Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200416bool operator<=(const charT* lhs, const basic_string<charT, traits, Allocator>& rhs) noexcept; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000417
418template<class charT, class traits, class Allocator>
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000419bool operator>=(const basic_string<charT, traits, Allocator>& lhs,
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200420 const basic_string<charT, traits, Allocator>& rhs) noexcept; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000421
422template<class charT, class traits, class Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200423bool operator>=(const basic_string<charT, traits, Allocator>& lhs, const charT* rhs) noexcept; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000424
425template<class charT, class traits, class Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200426bool operator>=(const charT* lhs, const basic_string<charT, traits, Allocator>& rhs) noexcept; // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000427
428template<class charT, class traits, class Allocator>
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000429void swap(basic_string<charT, traits, Allocator>& lhs,
Howard Hinnant3e276872011-06-03 18:40:47 +0000430 basic_string<charT, traits, Allocator>& rhs)
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200431 noexcept(noexcept(lhs.swap(rhs))); // constexpr since C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000432
433template<class charT, class traits, class Allocator>
434basic_istream<charT, traits>&
435operator>>(basic_istream<charT, traits>& is, basic_string<charT, traits, Allocator>& str);
436
437template<class charT, class traits, class Allocator>
438basic_ostream<charT, traits>&
439operator<<(basic_ostream<charT, traits>& os, const basic_string<charT, traits, Allocator>& str);
440
441template<class charT, class traits, class Allocator>
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000442basic_istream<charT, traits>&
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000443getline(basic_istream<charT, traits>& is, basic_string<charT, traits, Allocator>& str,
444 charT delim);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000445
446template<class charT, class traits, class Allocator>
447basic_istream<charT, traits>&
448getline(basic_istream<charT, traits>& is, basic_string<charT, traits, Allocator>& str);
449
Marshall Clow29b53f22018-12-14 18:49:35 +0000450template<class charT, class traits, class Allocator, class U>
Marek Kurdeja98b1412020-05-02 13:58:03 +0200451typename basic_string<charT, traits, Allocator>::size_type
452erase(basic_string<charT, traits, Allocator>& c, const U& value); // C++20
Marshall Clow29b53f22018-12-14 18:49:35 +0000453template<class charT, class traits, class Allocator, class Predicate>
Marek Kurdeja98b1412020-05-02 13:58:03 +0200454typename basic_string<charT, traits, Allocator>::size_type
455erase_if(basic_string<charT, traits, Allocator>& c, Predicate pred); // C++20
Marshall Clow29b53f22018-12-14 18:49:35 +0000456
Howard Hinnantc51e1022010-05-11 19:42:16 +0000457typedef basic_string<char> string;
458typedef basic_string<wchar_t> wstring;
Marek Kurdeje3ac4e22021-03-23 17:15:07 +0100459typedef basic_string<char8_t> u8string; // C++20
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000460typedef basic_string<char16_t> u16string;
461typedef basic_string<char32_t> u32string;
462
Bruce Mitchener170d8972020-11-24 12:53:53 -0500463int stoi (const string& str, size_t* idx = nullptr, int base = 10);
464long stol (const string& str, size_t* idx = nullptr, int base = 10);
465unsigned long stoul (const string& str, size_t* idx = nullptr, int base = 10);
466long long stoll (const string& str, size_t* idx = nullptr, int base = 10);
467unsigned long long stoull(const string& str, size_t* idx = nullptr, int base = 10);
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000468
Bruce Mitchener170d8972020-11-24 12:53:53 -0500469float stof (const string& str, size_t* idx = nullptr);
470double stod (const string& str, size_t* idx = nullptr);
471long double stold(const string& str, size_t* idx = nullptr);
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000472
473string to_string(int val);
474string to_string(unsigned val);
475string to_string(long val);
476string to_string(unsigned long val);
477string to_string(long long val);
478string to_string(unsigned long long val);
479string to_string(float val);
480string to_string(double val);
481string to_string(long double val);
482
Bruce Mitchener170d8972020-11-24 12:53:53 -0500483int stoi (const wstring& str, size_t* idx = nullptr, int base = 10);
484long stol (const wstring& str, size_t* idx = nullptr, int base = 10);
485unsigned long stoul (const wstring& str, size_t* idx = nullptr, int base = 10);
486long long stoll (const wstring& str, size_t* idx = nullptr, int base = 10);
487unsigned long long stoull(const wstring& str, size_t* idx = nullptr, int base = 10);
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000488
Bruce Mitchener170d8972020-11-24 12:53:53 -0500489float stof (const wstring& str, size_t* idx = nullptr);
490double stod (const wstring& str, size_t* idx = nullptr);
491long double stold(const wstring& str, size_t* idx = nullptr);
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +0000492
493wstring to_wstring(int val);
494wstring to_wstring(unsigned val);
495wstring to_wstring(long val);
496wstring to_wstring(unsigned long val);
497wstring to_wstring(long long val);
498wstring to_wstring(unsigned long long val);
499wstring to_wstring(float val);
500wstring to_wstring(double val);
501wstring to_wstring(long double val);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000502
503template <> struct hash<string>;
Marek Kurdeje3ac4e22021-03-23 17:15:07 +0100504template <> struct hash<u8string>; // C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000505template <> struct hash<u16string>;
506template <> struct hash<u32string>;
507template <> struct hash<wstring>;
508
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200509basic_string<char> operator "" s( const char *str, size_t len ); // C++14, constexpr since C++20
510basic_string<wchar_t> operator "" s( const wchar_t *str, size_t len ); // C++14, constexpr since C++20
511constexpr basic_string<char8_t> operator "" s( const char8_t *str, size_t len ); // C++20
512basic_string<char16_t> operator "" s( const char16_t *str, size_t len ); // C++14, constexpr since C++20
513basic_string<char32_t> operator "" s( const char32_t *str, size_t len ); // C++14, constexpr since C++20
Marshall Clowcba751f2013-07-23 17:05:24 +0000514
Howard Hinnantc51e1022010-05-11 19:42:16 +0000515} // std
516
517*/
518
Nikolas Klauserf210d8a2022-02-15 18:18:08 +0100519#include <__algorithm/max.h>
520#include <__algorithm/min.h>
521#include <__algorithm/remove.h>
522#include <__algorithm/remove_if.h>
Louis Dionneb4fce352022-03-25 12:55:36 -0400523#include <__assert> // all public C++ headers provide the assertion handler
Howard Hinnantc51e1022010-05-11 19:42:16 +0000524#include <__config>
Arthur O'Dwyeref181602021-05-19 11:57:04 -0400525#include <__debug>
Mark de Weverdf3e0d42021-09-26 15:47:42 +0200526#include <__format/enable_insertable.h>
Nikolas Klauser11a0ff32022-06-06 23:35:24 +0200527#include <__functional/hash.h>
Nikolas Klauser24540d32022-05-21 00:45:51 +0200528#include <__functional/unary_function.h>
Nikolas Klauser80840272022-02-04 13:04:33 +0100529#include <__ios/fpos.h>
Louis Dionne77249522021-06-11 09:55:11 -0400530#include <__iterator/wrap_iter.h>
Nikolas Klauserc513eba2022-04-09 09:41:19 +0200531#include <__memory/allocate_at_least.h>
Nikolas Klauser11a0ff32022-06-06 23:35:24 +0200532#include <__string/char_traits.h>
533#include <__string/extern_template_lists.h>
Nikolas Klauser8fccd622022-03-05 19:17:07 +0100534#include <__utility/auto_cast.h>
535#include <__utility/move.h>
536#include <__utility/swap.h>
Nikolas Klauser62060be2022-04-20 10:52:04 +0200537#include <__utility/unreachable.h>
538#include <climits>
Arthur O'Dwyeref181602021-05-19 11:57:04 -0400539#include <compare>
540#include <cstdio> // EOF
Louis Dionned24191c2021-08-19 12:39:16 -0400541#include <cstdlib>
Arthur O'Dwyeref181602021-05-19 11:57:04 -0400542#include <cstring>
Arthur O'Dwyeref181602021-05-19 11:57:04 -0400543#include <initializer_list>
544#include <iosfwd>
Howard Hinnantc51e1022010-05-11 19:42:16 +0000545#include <iterator>
Nikolas Klauser62060be2022-04-20 10:52:04 +0200546#include <limits>
Howard Hinnantc51e1022010-05-11 19:42:16 +0000547#include <memory>
548#include <stdexcept>
Arthur O'Dwyeref181602021-05-19 11:57:04 -0400549#include <string_view>
Howard Hinnantc51e1022010-05-11 19:42:16 +0000550#include <type_traits>
Marshall Clow0a1e7502018-09-12 19:41:40 +0000551#include <version>
Marshall Clowdf63a6d2016-07-21 05:31:24 +0000552
Nikolas Klauser4c1bf592022-02-11 19:15:18 +0100553// TODO: remove these headers
Nikolas Klauser4c1bf592022-02-11 19:15:18 +0100554#include <new>
555#include <typeinfo>
556
Louis Dionne89258142021-08-23 15:32:36 -0400557#ifndef _LIBCPP_HAS_NO_WIDE_CHARACTERS
Nikolas Klauser80840272022-02-04 13:04:33 +0100558# include <cwchar>
Louis Dionne89258142021-08-23 15:32:36 -0400559#endif
560
Arthur O'Dwyeref181602021-05-19 11:57:04 -0400561#ifndef _LIBCPP_HAS_NO_UNICODE_CHARS
Nikolas Klauser80840272022-02-04 13:04:33 +0100562# include <cstdint>
Arthur O'Dwyeref181602021-05-19 11:57:04 -0400563#endif
Eric Fiselier14b6de92014-08-10 23:53:08 +0000564
Howard Hinnantaaaa52b2011-10-17 20:05:10 +0000565#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
Arthur O'Dwyer6eeaa002022-02-01 20:16:40 -0500566# pragma GCC system_header
Howard Hinnantaaaa52b2011-10-17 20:05:10 +0000567#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +0000568
Eric Fiselierf4433a32017-05-31 22:07:49 +0000569_LIBCPP_PUSH_MACROS
570#include <__undef_macros>
571
572
Howard Hinnantc51e1022010-05-11 19:42:16 +0000573_LIBCPP_BEGIN_NAMESPACE_STD
574
Howard Hinnantc51e1022010-05-11 19:42:16 +0000575// basic_string
576
577template<class _CharT, class _Traits, class _Allocator>
578basic_string<_CharT, _Traits, _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200579_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnant944510a2011-06-14 19:58:17 +0000580operator+(const basic_string<_CharT, _Traits, _Allocator>& __x,
581 const basic_string<_CharT, _Traits, _Allocator>& __y);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000582
583template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200584_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +0000585basic_string<_CharT, _Traits, _Allocator>
Howard Hinnant944510a2011-06-14 19:58:17 +0000586operator+(const _CharT* __x, const basic_string<_CharT,_Traits,_Allocator>& __y);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000587
588template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200589_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +0000590basic_string<_CharT, _Traits, _Allocator>
Howard Hinnant944510a2011-06-14 19:58:17 +0000591operator+(_CharT __x, const basic_string<_CharT,_Traits,_Allocator>& __y);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000592
593template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200594inline _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +0000595basic_string<_CharT, _Traits, _Allocator>
Howard Hinnant944510a2011-06-14 19:58:17 +0000596operator+(const basic_string<_CharT, _Traits, _Allocator>& __x, const _CharT* __y);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000597
598template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200599_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +0000600basic_string<_CharT, _Traits, _Allocator>
Howard Hinnant944510a2011-06-14 19:58:17 +0000601operator+(const basic_string<_CharT, _Traits, _Allocator>& __x, _CharT __y);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000602
Louis Dionnedc496ec2021-06-08 17:25:08 -0400603extern template _LIBCPP_FUNC_VIS string operator+<char, char_traits<char>, allocator<char> >(char const*, string const&);
Shoaib Meenaiea363712017-07-29 02:54:41 +0000604
Marshall Clow039b2f02016-01-13 21:54:34 +0000605template <class _Iter>
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -0400606struct __string_is_trivial_iterator : public false_type {};
607
608template <class _Tp>
609struct __string_is_trivial_iterator<_Tp*>
610 : public is_arithmetic<_Tp> {};
Marshall Clow039b2f02016-01-13 21:54:34 +0000611
Louis Dionne173f29e2019-05-29 16:01:36 +0000612template <class _Iter>
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -0400613struct __string_is_trivial_iterator<__wrap_iter<_Iter> >
614 : public __string_is_trivial_iterator<_Iter> {};
Marshall Clow039b2f02016-01-13 21:54:34 +0000615
Marshall Clow82513342016-09-24 22:45:42 +0000616template <class _CharT, class _Traits, class _Tp>
Eric Fiselierc522ceb2020-01-15 16:57:08 -0500617struct __can_be_converted_to_string_view : public _BoolConstant<
618 is_convertible<const _Tp&, basic_string_view<_CharT, _Traits> >::value &&
619 !is_convertible<const _Tp&, const _CharT*>::value
620 > {};
Marshall Clow82513342016-09-24 22:45:42 +0000621
Arthur O'Dwyerafa5d5f2021-04-18 21:47:08 -0400622#ifndef _LIBCPP_HAS_NO_CHAR8_T
Richard Smith256954d2020-11-11 17:12:18 -0800623typedef basic_string<char8_t> u8string;
624#endif
625
626#ifndef _LIBCPP_HAS_NO_UNICODE_CHARS
627typedef basic_string<char16_t> u16string;
628typedef basic_string<char32_t> u32string;
Louis Dionne96fc5f52021-09-09 11:25:10 -0400629#endif
Richard Smith256954d2020-11-11 17:12:18 -0800630
Nikolas Klauser55dc8082022-04-09 16:19:45 +0200631struct __uninitialized_size_tag {};
632
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000633template<class _CharT, class _Traits, class _Allocator>
Richard Smith256954d2020-11-11 17:12:18 -0800634class
635 _LIBCPP_TEMPLATE_VIS
Arthur O'Dwyerafa5d5f2021-04-18 21:47:08 -0400636#ifndef _LIBCPP_HAS_NO_CHAR8_T
Richard Smith256954d2020-11-11 17:12:18 -0800637 _LIBCPP_PREFERRED_NAME(u8string)
638#endif
639#ifndef _LIBCPP_HAS_NO_UNICODE_CHARS
640 _LIBCPP_PREFERRED_NAME(u16string)
641 _LIBCPP_PREFERRED_NAME(u32string)
642#endif
643 basic_string
Howard Hinnantc51e1022010-05-11 19:42:16 +0000644{
645public:
646 typedef basic_string __self;
Marshall Clowdf63a6d2016-07-21 05:31:24 +0000647 typedef basic_string_view<_CharT, _Traits> __self_view;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000648 typedef _Traits traits_type;
Marshall Clowa3a74e02017-03-15 18:41:11 +0000649 typedef _CharT value_type;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000650 typedef _Allocator allocator_type;
Howard Hinnantea8f7e12010-11-17 17:55:08 +0000651 typedef allocator_traits<allocator_type> __alloc_traits;
652 typedef typename __alloc_traits::size_type size_type;
653 typedef typename __alloc_traits::difference_type difference_type;
Howard Hinnant3e276872011-06-03 18:40:47 +0000654 typedef value_type& reference;
655 typedef const value_type& const_reference;
Howard Hinnantea8f7e12010-11-17 17:55:08 +0000656 typedef typename __alloc_traits::pointer pointer;
657 typedef typename __alloc_traits::const_pointer const_pointer;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000658
Marshall Clow79f33542018-03-21 00:36:05 +0000659 static_assert((!is_array<value_type>::value), "Character type of basic_string must not be an array");
660 static_assert(( is_standard_layout<value_type>::value), "Character type of basic_string must be standard-layout");
661 static_assert(( is_trivial<value_type>::value), "Character type of basic_string must be trivial");
662 static_assert(( is_same<_CharT, typename traits_type::char_type>::value),
Howard Hinnant8ea98242013-08-23 17:37:05 +0000663 "traits_type::char_type must be the same type as CharT");
Marshall Clow79f33542018-03-21 00:36:05 +0000664 static_assert(( is_same<typename allocator_type::value_type, value_type>::value),
Howard Hinnant8ea98242013-08-23 17:37:05 +0000665 "Allocator::value_type must be same type as value_type");
Marshall Clowe46031a2018-07-02 18:41:15 +0000666
Howard Hinnantc51e1022010-05-11 19:42:16 +0000667 typedef __wrap_iter<pointer> iterator;
668 typedef __wrap_iter<const_pointer> const_iterator;
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200669 typedef std::reverse_iterator<iterator> reverse_iterator;
670 typedef std::reverse_iterator<const_iterator> const_reverse_iterator;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000671
672private:
Nikolas Klauser1aa21112022-05-14 12:38:00 +0200673 static_assert(CHAR_BIT == 8, "This implementation assumes that one byte contains 8 bits");
Howard Hinnant68bf1812013-04-30 21:44:48 +0000674
Evgeniy Stepanovda2ff7e2015-10-13 23:48:28 +0000675#ifdef _LIBCPP_ABI_ALTERNATE_STRING_LAYOUT
Howard Hinnant68bf1812013-04-30 21:44:48 +0000676
677 struct __long
678 {
679 pointer __data_;
680 size_type __size_;
Nikolas Klauser62060be2022-04-20 10:52:04 +0200681 size_type __cap_ : sizeof(size_type) * CHAR_BIT - 1;
682 size_type __is_long_ : 1;
Howard Hinnant68bf1812013-04-30 21:44:48 +0000683 };
684
Howard Hinnant68bf1812013-04-30 21:44:48 +0000685 enum {__min_cap = (sizeof(__long) - 1)/sizeof(value_type) > 2 ?
686 (sizeof(__long) - 1)/sizeof(value_type) : 2};
687
688 struct __short
689 {
690 value_type __data_[__min_cap];
Nikolas Klauser1aa21112022-05-14 12:38:00 +0200691 unsigned char __padding_[sizeof(value_type) - 1];
692 size_type __size_ : 7;
693 size_type __is_long_ : 1;
Howard Hinnant68bf1812013-04-30 21:44:48 +0000694 };
695
Nikolas Klauser62060be2022-04-20 10:52:04 +0200696// The __endian_factor is required because the field we use to store the size
Nikolas Klauser1aa21112022-05-14 12:38:00 +0200697// has one fewer bit than it would if it were not a bitfield.
Nikolas Klauser62060be2022-04-20 10:52:04 +0200698//
699// If the LSB is used to store the short-flag in the short string representation,
700// we have to multiply the size by two when it is stored and divide it by two when
701// it is loaded to make sure that we always store an even number. In the long string
702// representation, we can ignore this because we can assume that we always allocate
703// an even amount of value_types.
704//
705// If the MSB is used for the short-flag, the max_size() is numeric_limits<size_type>::max() / 2.
706// This does not impact the short string representation, since we never need the MSB
707// for representing the size of a short string anyway.
708
709#ifdef _LIBCPP_BIG_ENDIAN
710 static const size_type __endian_factor = 2;
Howard Hinnant68bf1812013-04-30 21:44:48 +0000711#else
Nikolas Klauser62060be2022-04-20 10:52:04 +0200712 static const size_type __endian_factor = 1;
713#endif
714
715#else // _LIBCPP_ABI_ALTERNATE_STRING_LAYOUT
716
717#ifdef _LIBCPP_BIG_ENDIAN
718 static const size_type __endian_factor = 1;
719#else
720 static const size_type __endian_factor = 2;
721#endif
Howard Hinnant68bf1812013-04-30 21:44:48 +0000722
Howard Hinnantc51e1022010-05-11 19:42:16 +0000723 struct __long
724 {
Nikolas Klauser62060be2022-04-20 10:52:04 +0200725 size_type __is_long_ : 1;
726 size_type __cap_ : sizeof(size_type) * CHAR_BIT - 1;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000727 size_type __size_;
728 pointer __data_;
729 };
730
Howard Hinnantc51e1022010-05-11 19:42:16 +0000731 enum {__min_cap = (sizeof(__long) - 1)/sizeof(value_type) > 2 ?
732 (sizeof(__long) - 1)/sizeof(value_type) : 2};
733
734 struct __short
735 {
Nikolas Klauser1aa21112022-05-14 12:38:00 +0200736 size_type __is_long_ : 1;
737 size_type __size_ : 7;
738 char __padding_[sizeof(value_type) - 1];
Howard Hinnantc51e1022010-05-11 19:42:16 +0000739 value_type __data_[__min_cap];
740 };
741
Louis Dionne2b1ceaa2021-04-20 12:03:32 -0400742#endif // _LIBCPP_ABI_ALTERNATE_STRING_LAYOUT
Howard Hinnant68bf1812013-04-30 21:44:48 +0000743
Howard Hinnant8ea98242013-08-23 17:37:05 +0000744 union __ulx{__long __lx; __short __lxx;};
Howard Hinnantc51e1022010-05-11 19:42:16 +0000745
Howard Hinnant8ea98242013-08-23 17:37:05 +0000746 enum {__n_words = sizeof(__ulx) / sizeof(size_type)};
Howard Hinnantc51e1022010-05-11 19:42:16 +0000747
748 struct __raw
749 {
750 size_type __words[__n_words];
751 };
752
753 struct __rep
754 {
755 union
756 {
757 __long __l;
758 __short __s;
759 __raw __r;
760 };
761 };
762
763 __compressed_pair<__rep, allocator_type> __r_;
764
Nikolas Klauser55dc8082022-04-09 16:19:45 +0200765 // Construct a string with the given allocator and enough storage to hold `__size` characters, but
766 // don't initialize the characters. The contents of the string, including the null terminator, must be
767 // initialized separately.
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200768 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
769 explicit basic_string(__uninitialized_size_tag, size_type __size, const allocator_type& __a)
Nikolas Klauser55dc8082022-04-09 16:19:45 +0200770 : __r_(__default_init_tag(), __a) {
771 if (__size > max_size())
772 __throw_length_error();
773 if (__fits_in_sso(__size)) {
774 __zero();
775 __set_short_size(__size);
776 } else {
777 auto __capacity = __recommend(__size) + 1;
778 auto __allocation = __alloc_traits::allocate(__alloc(), __capacity);
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200779 __begin_lifetime(__allocation, __capacity);
Nikolas Klauser55dc8082022-04-09 16:19:45 +0200780 __set_long_cap(__capacity);
781 __set_long_pointer(__allocation);
782 __set_long_size(__size);
783 }
784 std::__debug_db_insert_c(this);
785 }
786
Howard Hinnantc51e1022010-05-11 19:42:16 +0000787public:
Martin Storsjö88890c22021-02-22 01:13:13 +0200788 _LIBCPP_TEMPLATE_DATA_VIS
Howard Hinnantc51e1022010-05-11 19:42:16 +0000789 static const size_type npos = -1;
790
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200791 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string()
Howard Hinnant3e276872011-06-03 18:40:47 +0000792 _NOEXCEPT_(is_nothrow_default_constructible<allocator_type>::value);
Marshall Clowa80abc72015-06-03 19:56:43 +0000793
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200794 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17 explicit basic_string(const allocator_type& __a)
Marshall Clowa80abc72015-06-03 19:56:43 +0000795#if _LIBCPP_STD_VER <= 14
796 _NOEXCEPT_(is_nothrow_copy_constructible<allocator_type>::value);
797#else
798 _NOEXCEPT;
799#endif
800
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200801 _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string(const basic_string& __str);
802 _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string(const basic_string& __str, const allocator_type& __a);
Marshall Clowa80abc72015-06-03 19:56:43 +0000803
Eric Fiselierfc92be82017-04-19 00:28:44 +0000804#ifndef _LIBCPP_CXX03_LANG
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200805 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnant3e276872011-06-03 18:40:47 +0000806 basic_string(basic_string&& __str)
Marshall Clowa80abc72015-06-03 19:56:43 +0000807#if _LIBCPP_STD_VER <= 14
Howard Hinnant3e276872011-06-03 18:40:47 +0000808 _NOEXCEPT_(is_nothrow_move_constructible<allocator_type>::value);
Marshall Clowa80abc72015-06-03 19:56:43 +0000809#else
810 _NOEXCEPT;
811#endif
812
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200813 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +0000814 basic_string(basic_string&& __str, const allocator_type& __a);
Louis Dionne2b1ceaa2021-04-20 12:03:32 -0400815#endif // _LIBCPP_CXX03_LANG
Marshall Clowe46031a2018-07-02 18:41:15 +0000816
Louis Dionne9ce598d2021-09-08 09:14:43 -0400817 template <class = __enable_if_t<__is_allocator<_Allocator>::value, nullptr_t> >
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200818 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Eric Fiselier5169d1c2019-12-16 19:03:23 -0500819 basic_string(const _CharT* __s) : __r_(__default_init_tag(), __default_init_tag()) {
Eric Fiseliera8567862018-07-17 05:48:48 +0000820 _LIBCPP_ASSERT(__s != nullptr, "basic_string(const char*) detected nullptr");
821 __init(__s, traits_type::length(__s));
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200822 std::__debug_db_insert_c(this);
Eric Fiseliera8567862018-07-17 05:48:48 +0000823 }
Marshall Clowe46031a2018-07-02 18:41:15 +0000824
Louis Dionne9ce598d2021-09-08 09:14:43 -0400825 template <class = __enable_if_t<__is_allocator<_Allocator>::value, nullptr_t> >
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200826 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Marshall Clowe46031a2018-07-02 18:41:15 +0000827 basic_string(const _CharT* __s, const _Allocator& __a);
828
Marek Kurdej90d79712021-07-27 16:16:21 +0200829#if _LIBCPP_STD_VER > 20
830 basic_string(nullptr_t) = delete;
831#endif
832
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200833 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Eric Fiselier812882b2017-02-17 01:17:10 +0000834 basic_string(const _CharT* __s, size_type __n);
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200835 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Eric Fiselier812882b2017-02-17 01:17:10 +0000836 basic_string(const _CharT* __s, size_type __n, const _Allocator& __a);
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200837 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Eric Fiselier812882b2017-02-17 01:17:10 +0000838 basic_string(size_type __n, _CharT __c);
Marshall Clowe46031a2018-07-02 18:41:15 +0000839
Louis Dionne9ce598d2021-09-08 09:14:43 -0400840 template <class = __enable_if_t<__is_allocator<_Allocator>::value, nullptr_t> >
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200841 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Marshall Clowe46031a2018-07-02 18:41:15 +0000842 basic_string(size_type __n, _CharT __c, const _Allocator& __a);
843
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200844 _LIBCPP_CONSTEXPR_AFTER_CXX17
Marshall Clow83445802016-04-07 18:13:41 +0000845 basic_string(const basic_string& __str, size_type __pos, size_type __n,
Eric Fiselier812882b2017-02-17 01:17:10 +0000846 const _Allocator& __a = _Allocator());
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200847 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Marshall Clow83445802016-04-07 18:13:41 +0000848 basic_string(const basic_string& __str, size_type __pos,
Eric Fiselier812882b2017-02-17 01:17:10 +0000849 const _Allocator& __a = _Allocator());
Marshall Clowe46031a2018-07-02 18:41:15 +0000850
Louis Dionne9ce598d2021-09-08 09:14:43 -0400851 template<class _Tp, class = __enable_if_t<__can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value && !__is_same_uncvref<_Tp, basic_string>::value> >
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200852 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS _LIBCPP_CONSTEXPR_AFTER_CXX17
Eric Fiselier812882b2017-02-17 01:17:10 +0000853 basic_string(const _Tp& __t, size_type __pos, size_type __n,
Eric Fiselierc522ceb2020-01-15 16:57:08 -0500854 const allocator_type& __a = allocator_type());
Marshall Clowe46031a2018-07-02 18:41:15 +0000855
Louis Dionne9ce598d2021-09-08 09:14:43 -0400856 template<class _Tp, class = __enable_if_t<__can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value &&
Eric Fiselierc522ceb2020-01-15 16:57:08 -0500857 !__is_same_uncvref<_Tp, basic_string>::value> >
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200858 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS _LIBCPP_CONSTEXPR_AFTER_CXX17
Marshall Clowe46031a2018-07-02 18:41:15 +0000859 explicit basic_string(const _Tp& __t);
860
Louis Dionne9ce598d2021-09-08 09:14:43 -0400861 template<class _Tp, class = __enable_if_t<__can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value && !__is_same_uncvref<_Tp, basic_string>::value> >
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200862 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS _LIBCPP_CONSTEXPR_AFTER_CXX17
Marshall Clowe46031a2018-07-02 18:41:15 +0000863 explicit basic_string(const _Tp& __t, const allocator_type& __a);
864
Louis Dionne9ce598d2021-09-08 09:14:43 -0400865 template<class _InputIterator, class = __enable_if_t<__is_cpp17_input_iterator<_InputIterator>::value> >
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200866 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +0000867 basic_string(_InputIterator __first, _InputIterator __last);
Louis Dionne9ce598d2021-09-08 09:14:43 -0400868 template<class _InputIterator, class = __enable_if_t<__is_cpp17_input_iterator<_InputIterator>::value> >
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200869 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +0000870 basic_string(_InputIterator __first, _InputIterator __last, const allocator_type& __a);
Eric Fiselierfc92be82017-04-19 00:28:44 +0000871#ifndef _LIBCPP_CXX03_LANG
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200872 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Eric Fiselier812882b2017-02-17 01:17:10 +0000873 basic_string(initializer_list<_CharT> __il);
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200874 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Eric Fiselier812882b2017-02-17 01:17:10 +0000875 basic_string(initializer_list<_CharT> __il, const _Allocator& __a);
Louis Dionne2b1ceaa2021-04-20 12:03:32 -0400876#endif // _LIBCPP_CXX03_LANG
Howard Hinnantc51e1022010-05-11 19:42:16 +0000877
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200878 inline _LIBCPP_CONSTEXPR_AFTER_CXX17 ~basic_string();
Howard Hinnantc51e1022010-05-11 19:42:16 +0000879
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200880 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Marshall Clowdf63a6d2016-07-21 05:31:24 +0000881 operator __self_view() const _NOEXCEPT { return __self_view(data(), size()); }
882
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200883 _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string& operator=(const basic_string& __str);
Eric Fiselier5ec13b12017-01-23 21:24:58 +0000884
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200885 template <class _Tp, class = __enable_if_t<__can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value &&
886 !__is_same_uncvref<_Tp, basic_string>::value> >
887 _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string& operator=(const _Tp& __t) {
888 __self_view __sv = __t;
889 return assign(__sv);
890 }
Marshall Clowe46031a2018-07-02 18:41:15 +0000891
Eric Fiselierfc92be82017-04-19 00:28:44 +0000892#ifndef _LIBCPP_CXX03_LANG
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200893 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnant3e276872011-06-03 18:40:47 +0000894 basic_string& operator=(basic_string&& __str)
Marshall Clow2fe8a8d2015-08-18 18:57:00 +0000895 _NOEXCEPT_((__noexcept_move_assign_container<_Allocator, __alloc_traits>::value));
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200896 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Eric Fiselierfc92be82017-04-19 00:28:44 +0000897 basic_string& operator=(initializer_list<value_type> __il) {return assign(__il.begin(), __il.size());}
Howard Hinnantc51e1022010-05-11 19:42:16 +0000898#endif
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200899 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200900 basic_string& operator=(const value_type* __s) {return assign(__s);}
Marek Kurdej90d79712021-07-27 16:16:21 +0200901#if _LIBCPP_STD_VER > 20
902 basic_string& operator=(nullptr_t) = delete;
903#endif
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200904 _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string& operator=(value_type __c);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000905
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200906 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnant8ea98242013-08-23 17:37:05 +0000907 iterator begin() _NOEXCEPT
908 {return iterator(this, __get_pointer());}
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200909 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnant8ea98242013-08-23 17:37:05 +0000910 const_iterator begin() const _NOEXCEPT
911 {return const_iterator(this, __get_pointer());}
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200912 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnant8ea98242013-08-23 17:37:05 +0000913 iterator end() _NOEXCEPT
914 {return iterator(this, __get_pointer() + size());}
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200915 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnant8ea98242013-08-23 17:37:05 +0000916 const_iterator end() const _NOEXCEPT
917 {return const_iterator(this, __get_pointer() + size());}
Louis Dionnee554e102022-06-03 15:17:03 -0400918
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200919 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000920 reverse_iterator rbegin() _NOEXCEPT
921 {return reverse_iterator(end());}
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200922 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000923 const_reverse_iterator rbegin() const _NOEXCEPT
924 {return const_reverse_iterator(end());}
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200925 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000926 reverse_iterator rend() _NOEXCEPT
927 {return reverse_iterator(begin());}
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200928 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000929 const_reverse_iterator rend() const _NOEXCEPT
930 {return const_reverse_iterator(begin());}
Howard Hinnantc51e1022010-05-11 19:42:16 +0000931
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200932 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000933 const_iterator cbegin() const _NOEXCEPT
934 {return begin();}
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200935 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000936 const_iterator cend() const _NOEXCEPT
937 {return end();}
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200938 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000939 const_reverse_iterator crbegin() const _NOEXCEPT
940 {return rbegin();}
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200941 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantaeb17d82011-05-29 19:57:12 +0000942 const_reverse_iterator crend() const _NOEXCEPT
943 {return rend();}
Howard Hinnantc51e1022010-05-11 19:42:16 +0000944
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200945 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17 size_type size() const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +0000946 {return __is_long() ? __get_long_size() : __get_short_size();}
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200947 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17 size_type length() const _NOEXCEPT {return size();}
948 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17 size_type max_size() const _NOEXCEPT;
949 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17 size_type capacity() const _NOEXCEPT {
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200950 return (__is_long() ? __get_long_cap() : static_cast<size_type>(__min_cap)) - 1;
951 }
Howard Hinnantc51e1022010-05-11 19:42:16 +0000952
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200953 _LIBCPP_CONSTEXPR_AFTER_CXX17 void resize(size_type __n, value_type __c);
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200954 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17 void resize(size_type __n) { resize(__n, value_type()); }
Howard Hinnantc51e1022010-05-11 19:42:16 +0000955
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200956 _LIBCPP_CONSTEXPR_AFTER_CXX17 void reserve(size_type __requested_capacity);
Nikolas Klauser9e6040c2022-01-06 21:43:26 +0100957
958#if _LIBCPP_STD_VER > 20
959 template <class _Op>
960 _LIBCPP_HIDE_FROM_ABI constexpr
961 void resize_and_overwrite(size_type __n, _Op __op) {
962 __resize_default_init(__n);
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200963 __erase_to_end(std::move(__op)(data(), _LIBCPP_AUTO_CAST(__n)));
Nikolas Klauser9e6040c2022-01-06 21:43:26 +0100964 }
965#endif
966
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200967 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17 void __resize_default_init(size_type __n);
Eric Fiselier451d5582018-11-26 20:15:38 +0000968
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200969 _LIBCPP_DEPRECATED_IN_CXX20 _LIBCPP_HIDE_FROM_ABI void reserve() _NOEXCEPT { shrink_to_fit(); }
970 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17 void shrink_to_fit() _NOEXCEPT;
971 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17 void clear() _NOEXCEPT;
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200972
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200973 _LIBCPP_NODISCARD_AFTER_CXX17 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Marshall Clowb7db4972017-11-15 20:02:27 +0000974 bool empty() const _NOEXCEPT {return size() == 0;}
Howard Hinnantc51e1022010-05-11 19:42:16 +0000975
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200976 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200977 const_reference operator[](size_type __pos) const _NOEXCEPT;
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200978 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17 reference operator[](size_type __pos) _NOEXCEPT;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000979
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200980 _LIBCPP_CONSTEXPR_AFTER_CXX17 const_reference at(size_type __n) const;
981 _LIBCPP_CONSTEXPR_AFTER_CXX17 reference at(size_type __n);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000982
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200983 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string& operator+=(const basic_string& __str) {
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200984 return append(__str);
985 }
Marshall Clowe46031a2018-07-02 18:41:15 +0000986
987 template <class _Tp>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200988 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS _LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -0400989 __enable_if_t
Marshall Clowe46031a2018-07-02 18:41:15 +0000990 <
Eric Fiselierc522ceb2020-01-15 16:57:08 -0500991 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value
992 && !__is_same_uncvref<_Tp, basic_string >::value,
Marshall Clowe46031a2018-07-02 18:41:15 +0000993 basic_string&
Eric Fiselierc522ceb2020-01-15 16:57:08 -0500994 >
Nikolas Klauser80b3cf32022-04-27 10:11:44 +0200995 operator+=(const _Tp& __t) {
996 __self_view __sv = __t; return append(__sv);
997 }
998
Nikolas Klauser1d5108d2022-04-29 11:17:58 +0200999 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string& operator+=(const value_type* __s) {
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001000 return append(__s);
1001 }
1002
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001003 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string& operator+=(value_type __c) {
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001004 push_back(__c);
1005 return *this;
1006 }
1007
Eric Fiselierfc92be82017-04-19 00:28:44 +00001008#ifndef _LIBCPP_CXX03_LANG
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001009 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001010 basic_string& operator+=(initializer_list<value_type> __il) { return append(__il); }
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04001011#endif // _LIBCPP_CXX03_LANG
Howard Hinnantc51e1022010-05-11 19:42:16 +00001012
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001013 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00001014 basic_string& append(const basic_string& __str);
Marshall Clowe46031a2018-07-02 18:41:15 +00001015
1016 template <class _Tp>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001017 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS _LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04001018 __enable_if_t<
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001019 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value
1020 && !__is_same_uncvref<_Tp, basic_string>::value,
Marshall Clowe46031a2018-07-02 18:41:15 +00001021 basic_string&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001022 >
Marshall Clowe46031a2018-07-02 18:41:15 +00001023 append(const _Tp& __t) { __self_view __sv = __t; return append(__sv.data(), __sv.size()); }
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001024 _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string& append(const basic_string& __str, size_type __pos, size_type __n=npos);
Marshall Clowe46031a2018-07-02 18:41:15 +00001025
Marshall Clow62953962016-10-03 23:40:48 +00001026 template <class _Tp>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001027 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS _LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04001028 __enable_if_t
Marshall Clow82513342016-09-24 22:45:42 +00001029 <
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001030 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value
1031 && !__is_same_uncvref<_Tp, basic_string>::value,
Marshall Clow82513342016-09-24 22:45:42 +00001032 basic_string&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001033 >
Marshall Clow82513342016-09-24 22:45:42 +00001034 append(const _Tp& __t, size_type __pos, size_type __n=npos);
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001035 _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string& append(const value_type* __s, size_type __n);
1036 _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string& append(const value_type* __s);
1037 _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string& append(size_type __n, value_type __c);
Eric Fiselier451d5582018-11-26 20:15:38 +00001038
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001039 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Eric Fiselier451d5582018-11-26 20:15:38 +00001040 void __append_default_init(size_type __n);
1041
Howard Hinnantc51e1022010-05-11 19:42:16 +00001042 template<class _InputIterator>
Shoaib Meenai69c57412017-03-02 03:02:50 +00001043 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
Louis Dionne9ce598d2021-09-08 09:14:43 -04001044 __enable_if_t
Howard Hinnantc51e1022010-05-11 19:42:16 +00001045 <
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04001046 __is_exactly_cpp17_input_iterator<_InputIterator>::value,
Howard Hinnantc51e1022010-05-11 19:42:16 +00001047 basic_string&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001048 >
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001049 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Eric Fiselierdb7ee8f2016-10-31 02:46:25 +00001050 append(_InputIterator __first, _InputIterator __last) {
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04001051 const basic_string __temp(__first, __last, __alloc());
Eric Fiselierdb7ee8f2016-10-31 02:46:25 +00001052 append(__temp.data(), __temp.size());
1053 return *this;
1054 }
Howard Hinnantc51e1022010-05-11 19:42:16 +00001055 template<class _ForwardIterator>
Shoaib Meenai69c57412017-03-02 03:02:50 +00001056 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
Louis Dionne9ce598d2021-09-08 09:14:43 -04001057 __enable_if_t
Howard Hinnantc51e1022010-05-11 19:42:16 +00001058 <
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04001059 __is_cpp17_forward_iterator<_ForwardIterator>::value,
Howard Hinnantc51e1022010-05-11 19:42:16 +00001060 basic_string&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001061 >
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001062 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04001063 append(_ForwardIterator __first, _ForwardIterator __last);
Eric Fiselierdb7ee8f2016-10-31 02:46:25 +00001064
Eric Fiselierfc92be82017-04-19 00:28:44 +00001065#ifndef _LIBCPP_CXX03_LANG
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001066 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00001067 basic_string& append(initializer_list<value_type> __il) {return append(__il.begin(), __il.size());}
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04001068#endif // _LIBCPP_CXX03_LANG
Howard Hinnantc51e1022010-05-11 19:42:16 +00001069
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001070 _LIBCPP_CONSTEXPR_AFTER_CXX17 void push_back(value_type __c);
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001071 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17 void pop_back();
1072 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17 reference front() _NOEXCEPT;
1073 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17 const_reference front() const _NOEXCEPT;
1074 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17 reference back() _NOEXCEPT;
1075 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17 const_reference back() const _NOEXCEPT;
Howard Hinnantc51e1022010-05-11 19:42:16 +00001076
Marshall Clowe46031a2018-07-02 18:41:15 +00001077 template <class _Tp>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001078 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS _LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04001079 __enable_if_t
Marshall Clowe46031a2018-07-02 18:41:15 +00001080 <
1081 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
1082 basic_string&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001083 >
Marshall Clowe46031a2018-07-02 18:41:15 +00001084 assign(const _Tp & __t) { __self_view __sv = __t; return assign(__sv.data(), __sv.size()); }
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001085 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Marshall Clow95d5e9a2016-03-09 18:08:29 +00001086 basic_string& assign(const basic_string& __str) { return *this = __str; }
Eric Fiselierfc92be82017-04-19 00:28:44 +00001087#ifndef _LIBCPP_CXX03_LANG
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001088 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Eric Fiselierc5ea1ae2017-06-01 02:29:37 +00001089 basic_string& assign(basic_string&& __str)
Marshall Clow5aa9e942015-10-05 16:17:34 +00001090 _NOEXCEPT_((__noexcept_move_assign_container<_Allocator, __alloc_traits>::value))
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001091 {*this = std::move(__str); return *this;}
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001092#endif
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001093 _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string& assign(const basic_string& __str, size_type __pos, size_type __n=npos);
Marshall Clow62953962016-10-03 23:40:48 +00001094 template <class _Tp>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001095 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS _LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04001096 __enable_if_t
Marshall Clow82513342016-09-24 22:45:42 +00001097 <
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001098 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value
1099 && !__is_same_uncvref<_Tp, basic_string>::value,
Marshall Clow82513342016-09-24 22:45:42 +00001100 basic_string&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001101 >
Eric Fiselierc5ea1ae2017-06-01 02:29:37 +00001102 assign(const _Tp & __t, size_type __pos, size_type __n=npos);
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001103 _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string& assign(const value_type* __s, size_type __n);
1104 _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string& assign(const value_type* __s);
1105 _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string& assign(size_type __n, value_type __c);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001106 template<class _InputIterator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001107 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS _LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04001108 __enable_if_t
Howard Hinnantc51e1022010-05-11 19:42:16 +00001109 <
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04001110 __is_exactly_cpp17_input_iterator<_InputIterator>::value,
Howard Hinnantc51e1022010-05-11 19:42:16 +00001111 basic_string&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001112 >
Howard Hinnantc51e1022010-05-11 19:42:16 +00001113 assign(_InputIterator __first, _InputIterator __last);
1114 template<class _ForwardIterator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001115 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS _LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04001116 __enable_if_t
Howard Hinnantc51e1022010-05-11 19:42:16 +00001117 <
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04001118 __is_cpp17_forward_iterator<_ForwardIterator>::value,
Howard Hinnantc51e1022010-05-11 19:42:16 +00001119 basic_string&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001120 >
Howard Hinnantc51e1022010-05-11 19:42:16 +00001121 assign(_ForwardIterator __first, _ForwardIterator __last);
Eric Fiselierfc92be82017-04-19 00:28:44 +00001122#ifndef _LIBCPP_CXX03_LANG
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001123 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00001124 basic_string& assign(initializer_list<value_type> __il) {return assign(__il.begin(), __il.size());}
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04001125#endif // _LIBCPP_CXX03_LANG
Howard Hinnantc51e1022010-05-11 19:42:16 +00001126
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001127 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00001128 basic_string& insert(size_type __pos1, const basic_string& __str);
Marshall Clowe46031a2018-07-02 18:41:15 +00001129
1130 template <class _Tp>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001131 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS _LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04001132 __enable_if_t
Marshall Clowe46031a2018-07-02 18:41:15 +00001133 <
1134 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
1135 basic_string&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001136 >
Marshall Clowe46031a2018-07-02 18:41:15 +00001137 insert(size_type __pos1, const _Tp& __t)
1138 { __self_view __sv = __t; return insert(__pos1, __sv.data(), __sv.size()); }
1139
Marshall Clow82513342016-09-24 22:45:42 +00001140 template <class _Tp>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001141 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS _LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04001142 __enable_if_t
Marshall Clow82513342016-09-24 22:45:42 +00001143 <
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001144 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value && !__is_same_uncvref<_Tp, basic_string>::value,
Marshall Clow82513342016-09-24 22:45:42 +00001145 basic_string&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001146 >
Marshall Clow82513342016-09-24 22:45:42 +00001147 insert(size_type __pos1, const _Tp& __t, size_type __pos2, size_type __n=npos);
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001148 _LIBCPP_CONSTEXPR_AFTER_CXX17
Marshall Clow8db7fb02014-03-04 19:17:19 +00001149 basic_string& insert(size_type __pos1, const basic_string& __str, size_type __pos2, size_type __n=npos);
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001150 _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string& insert(size_type __pos, const value_type* __s, size_type __n);
1151 _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string& insert(size_type __pos, const value_type* __s);
1152 _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string& insert(size_type __pos, size_type __n, value_type __c);
1153 _LIBCPP_CONSTEXPR_AFTER_CXX17 iterator insert(const_iterator __pos, value_type __c);
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001154 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00001155 iterator insert(const_iterator __pos, size_type __n, value_type __c);
1156 template<class _InputIterator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001157 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS _LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04001158 __enable_if_t
Howard Hinnantc51e1022010-05-11 19:42:16 +00001159 <
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04001160 __is_exactly_cpp17_input_iterator<_InputIterator>::value,
Howard Hinnantc51e1022010-05-11 19:42:16 +00001161 iterator
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001162 >
Howard Hinnantc51e1022010-05-11 19:42:16 +00001163 insert(const_iterator __pos, _InputIterator __first, _InputIterator __last);
1164 template<class _ForwardIterator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001165 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS _LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04001166 __enable_if_t
Howard Hinnantc51e1022010-05-11 19:42:16 +00001167 <
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04001168 __is_cpp17_forward_iterator<_ForwardIterator>::value,
Howard Hinnantc51e1022010-05-11 19:42:16 +00001169 iterator
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001170 >
Howard Hinnantc51e1022010-05-11 19:42:16 +00001171 insert(const_iterator __pos, _ForwardIterator __first, _ForwardIterator __last);
Eric Fiselierfc92be82017-04-19 00:28:44 +00001172#ifndef _LIBCPP_CXX03_LANG
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001173 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00001174 iterator insert(const_iterator __pos, initializer_list<value_type> __il)
1175 {return insert(__pos, __il.begin(), __il.end());}
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04001176#endif // _LIBCPP_CXX03_LANG
Howard Hinnantc51e1022010-05-11 19:42:16 +00001177
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001178 _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string& erase(size_type __pos = 0, size_type __n = npos);
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001179 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00001180 iterator erase(const_iterator __pos);
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001181 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00001182 iterator erase(const_iterator __first, const_iterator __last);
1183
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001184 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00001185 basic_string& replace(size_type __pos1, size_type __n1, const basic_string& __str);
Marshall Clowe46031a2018-07-02 18:41:15 +00001186
1187 template <class _Tp>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001188 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS _LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04001189 __enable_if_t
Marshall Clowe46031a2018-07-02 18:41:15 +00001190 <
1191 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
1192 basic_string&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001193 >
Marshall Clowe46031a2018-07-02 18:41:15 +00001194 replace(size_type __pos1, size_type __n1, const _Tp& __t) { __self_view __sv = __t; return replace(__pos1, __n1, __sv.data(), __sv.size()); }
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001195 _LIBCPP_CONSTEXPR_AFTER_CXX17
Marshall Clow8db7fb02014-03-04 19:17:19 +00001196 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 +00001197 template <class _Tp>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001198 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS _LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04001199 __enable_if_t
Marshall Clow82513342016-09-24 22:45:42 +00001200 <
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001201 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value && !__is_same_uncvref<_Tp, basic_string>::value,
Marshall Clow82513342016-09-24 22:45:42 +00001202 basic_string&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001203 >
Marshall Clow82513342016-09-24 22:45:42 +00001204 replace(size_type __pos1, size_type __n1, const _Tp& __t, size_type __pos2, size_type __n2=npos);
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001205 _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantd17880b2013-06-28 16:59:19 +00001206 basic_string& replace(size_type __pos, size_type __n1, const value_type* __s, size_type __n2);
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001207 _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string& replace(size_type __pos, size_type __n1, const value_type* __s);
1208 _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string& replace(size_type __pos, size_type __n1, size_type __n2, value_type __c);
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001209 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnant990d6e82010-11-17 21:11:40 +00001210 basic_string& replace(const_iterator __i1, const_iterator __i2, const basic_string& __str);
Marshall Clowe46031a2018-07-02 18:41:15 +00001211
1212 template <class _Tp>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001213 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS _LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04001214 __enable_if_t
Marshall Clowe46031a2018-07-02 18:41:15 +00001215 <
1216 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
1217 basic_string&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001218 >
Marshall Clowe46031a2018-07-02 18:41:15 +00001219 replace(const_iterator __i1, const_iterator __i2, const _Tp& __t) { __self_view __sv = __t; return replace(__i1 - begin(), __i2 - __i1, __sv); }
1220
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001221 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantd17880b2013-06-28 16:59:19 +00001222 basic_string& replace(const_iterator __i1, const_iterator __i2, const value_type* __s, size_type __n);
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001223 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantd17880b2013-06-28 16:59:19 +00001224 basic_string& replace(const_iterator __i1, const_iterator __i2, const value_type* __s);
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001225 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnant990d6e82010-11-17 21:11:40 +00001226 basic_string& replace(const_iterator __i1, const_iterator __i2, size_type __n, value_type __c);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001227 template<class _InputIterator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001228 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS _LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04001229 __enable_if_t
Howard Hinnantc51e1022010-05-11 19:42:16 +00001230 <
Eric Fiseliercd5a6772019-11-18 01:46:58 -05001231 __is_cpp17_input_iterator<_InputIterator>::value,
Howard Hinnantc51e1022010-05-11 19:42:16 +00001232 basic_string&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001233 >
Howard Hinnant990d6e82010-11-17 21:11:40 +00001234 replace(const_iterator __i1, const_iterator __i2, _InputIterator __j1, _InputIterator __j2);
Eric Fiselierfc92be82017-04-19 00:28:44 +00001235#ifndef _LIBCPP_CXX03_LANG
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001236 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnant990d6e82010-11-17 21:11:40 +00001237 basic_string& replace(const_iterator __i1, const_iterator __i2, initializer_list<value_type> __il)
Howard Hinnantc51e1022010-05-11 19:42:16 +00001238 {return replace(__i1, __i2, __il.begin(), __il.end());}
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04001239#endif // _LIBCPP_CXX03_LANG
Howard Hinnantc51e1022010-05-11 19:42:16 +00001240
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001241 _LIBCPP_CONSTEXPR_AFTER_CXX17 size_type copy(value_type* __s, size_type __n, size_type __pos = 0) const;
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001242 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00001243 basic_string substr(size_type __pos = 0, size_type __n = npos) const;
1244
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001245 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnant3e276872011-06-03 18:40:47 +00001246 void swap(basic_string& __str)
Marshall Clow8982dcd2015-07-13 20:04:56 +00001247#if _LIBCPP_STD_VER >= 14
Eric Fiselier873b8d32019-03-18 21:50:12 +00001248 _NOEXCEPT;
Marshall Clow8982dcd2015-07-13 20:04:56 +00001249#else
Eric Fiselier873b8d32019-03-18 21:50:12 +00001250 _NOEXCEPT_(!__alloc_traits::propagate_on_container_swap::value ||
Marshall Clow8982dcd2015-07-13 20:04:56 +00001251 __is_nothrow_swappable<allocator_type>::value);
1252#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +00001253
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001254 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantd17880b2013-06-28 16:59:19 +00001255 const value_type* c_str() const _NOEXCEPT {return data();}
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001256 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
1257 const value_type* data() const _NOEXCEPT {return std::__to_address(__get_pointer());}
Eric Fiselier4ee2a892017-11-20 20:23:27 +00001258#if _LIBCPP_STD_VER > 14 || defined(_LIBCPP_BUILDING_LIBRARY)
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001259 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
1260 value_type* data() _NOEXCEPT {return std::__to_address(__get_pointer());}
Marshall Clowd3c22392016-03-08 15:44:30 +00001261#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +00001262
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001263 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001264 allocator_type get_allocator() const _NOEXCEPT {return __alloc();}
Howard Hinnantc51e1022010-05-11 19:42:16 +00001265
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001266 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001267 size_type find(const basic_string& __str, size_type __pos = 0) const _NOEXCEPT;
Marshall Clowe46031a2018-07-02 18:41:15 +00001268
1269 template <class _Tp>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001270 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS _LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04001271 __enable_if_t
Marshall Clowe46031a2018-07-02 18:41:15 +00001272 <
1273 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
1274 size_type
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001275 >
zoecarver1997e0a2021-02-05 11:54:47 -08001276 find(const _Tp& __t, size_type __pos = 0) const _NOEXCEPT;
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001277 _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantd17880b2013-06-28 16:59:19 +00001278 size_type find(const value_type* __s, size_type __pos, size_type __n) const _NOEXCEPT;
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001279 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantd17880b2013-06-28 16:59:19 +00001280 size_type find(const value_type* __s, size_type __pos = 0) const _NOEXCEPT;
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001281 _LIBCPP_CONSTEXPR_AFTER_CXX17 size_type find(value_type __c, size_type __pos = 0) const _NOEXCEPT;
Howard Hinnantc51e1022010-05-11 19:42:16 +00001282
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001283 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001284 size_type rfind(const basic_string& __str, size_type __pos = npos) const _NOEXCEPT;
Marshall Clowe46031a2018-07-02 18:41:15 +00001285
1286 template <class _Tp>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001287 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS _LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04001288 __enable_if_t
Marshall Clowe46031a2018-07-02 18:41:15 +00001289 <
1290 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
1291 size_type
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001292 >
zoecarver1997e0a2021-02-05 11:54:47 -08001293 rfind(const _Tp& __t, size_type __pos = npos) const _NOEXCEPT;
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001294 _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantd17880b2013-06-28 16:59:19 +00001295 size_type rfind(const value_type* __s, size_type __pos, size_type __n) const _NOEXCEPT;
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001296 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantd17880b2013-06-28 16:59:19 +00001297 size_type rfind(const value_type* __s, size_type __pos = npos) const _NOEXCEPT;
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001298 _LIBCPP_CONSTEXPR_AFTER_CXX17 size_type rfind(value_type __c, size_type __pos = npos) const _NOEXCEPT;
Howard Hinnantc51e1022010-05-11 19:42:16 +00001299
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001300 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001301 size_type find_first_of(const basic_string& __str, size_type __pos = 0) const _NOEXCEPT;
Marshall Clowe46031a2018-07-02 18:41:15 +00001302
1303 template <class _Tp>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001304 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS _LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04001305 __enable_if_t
Marshall Clowe46031a2018-07-02 18:41:15 +00001306 <
1307 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
1308 size_type
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001309 >
zoecarver1997e0a2021-02-05 11:54:47 -08001310 find_first_of(const _Tp& __t, size_type __pos = 0) const _NOEXCEPT;
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001311 _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantd17880b2013-06-28 16:59:19 +00001312 size_type find_first_of(const value_type* __s, size_type __pos, size_type __n) const _NOEXCEPT;
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001313 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantd17880b2013-06-28 16:59:19 +00001314 size_type find_first_of(const value_type* __s, size_type __pos = 0) const _NOEXCEPT;
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001315 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001316 size_type find_first_of(value_type __c, size_type __pos = 0) const _NOEXCEPT;
Howard Hinnantc51e1022010-05-11 19:42:16 +00001317
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001318 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001319 size_type find_last_of(const basic_string& __str, size_type __pos = npos) const _NOEXCEPT;
Marshall Clowe46031a2018-07-02 18:41:15 +00001320
1321 template <class _Tp>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001322 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS _LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04001323 __enable_if_t
Marshall Clowe46031a2018-07-02 18:41:15 +00001324 <
1325 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
1326 size_type
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001327 >
zoecarver1997e0a2021-02-05 11:54:47 -08001328 find_last_of(const _Tp& __t, size_type __pos = npos) const _NOEXCEPT;
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001329 _LIBCPP_CONSTEXPR_AFTER_CXX17
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;
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001331 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantd17880b2013-06-28 16:59:19 +00001332 size_type find_last_of(const value_type* __s, size_type __pos = npos) const _NOEXCEPT;
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001333 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
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
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001336 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
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>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001340 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS _LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04001341 __enable_if_t
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;
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001347 _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantd17880b2013-06-28 16:59:19 +00001348 size_type find_first_not_of(const value_type* __s, size_type __pos, size_type __n) const _NOEXCEPT;
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001349 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantd17880b2013-06-28 16:59:19 +00001350 size_type find_first_not_of(const value_type* __s, size_type __pos = 0) const _NOEXCEPT;
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001351 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001352 size_type find_first_not_of(value_type __c, size_type __pos = 0) const _NOEXCEPT;
1353
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001354 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001355 size_type find_last_not_of(const basic_string& __str, size_type __pos = npos) const _NOEXCEPT;
Marshall Clowe46031a2018-07-02 18:41:15 +00001356
1357 template <class _Tp>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001358 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS _LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04001359 __enable_if_t
Marshall Clowe46031a2018-07-02 18:41:15 +00001360 <
1361 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
1362 size_type
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001363 >
zoecarver1997e0a2021-02-05 11:54:47 -08001364 find_last_not_of(const _Tp& __t, size_type __pos = npos) const _NOEXCEPT;
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001365 _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantd17880b2013-06-28 16:59:19 +00001366 size_type find_last_not_of(const value_type* __s, size_type __pos, size_type __n) const _NOEXCEPT;
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001367 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantd17880b2013-06-28 16:59:19 +00001368 size_type find_last_not_of(const value_type* __s, size_type __pos = npos) const _NOEXCEPT;
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001369 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001370 size_type find_last_not_of(value_type __c, size_type __pos = npos) const _NOEXCEPT;
1371
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001372 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001373 int compare(const basic_string& __str) const _NOEXCEPT;
Marshall Clowe46031a2018-07-02 18:41:15 +00001374
1375 template <class _Tp>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001376 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS _LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04001377 __enable_if_t
Marshall Clowe46031a2018-07-02 18:41:15 +00001378 <
1379 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
1380 int
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001381 >
zoecarver1997e0a2021-02-05 11:54:47 -08001382 compare(const _Tp &__t) const _NOEXCEPT;
Marshall Clowe46031a2018-07-02 18:41:15 +00001383
1384 template <class _Tp>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001385 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS _LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04001386 __enable_if_t
Marshall Clowe46031a2018-07-02 18:41:15 +00001387 <
1388 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
1389 int
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001390 >
Marshall Clowe46031a2018-07-02 18:41:15 +00001391 compare(size_type __pos1, size_type __n1, const _Tp& __t) const;
1392
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001393 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00001394 int compare(size_type __pos1, size_type __n1, const basic_string& __str) const;
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001395 _LIBCPP_CONSTEXPR_AFTER_CXX17
1396 int compare(size_type __pos1, size_type __n1, const basic_string& __str, size_type __pos2,
1397 size_type __n2 = npos) const;
Marshall Clowe46031a2018-07-02 18:41:15 +00001398
Marshall Clow82513342016-09-24 22:45:42 +00001399 template <class _Tp>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001400 inline _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04001401 __enable_if_t
Marshall Clow82513342016-09-24 22:45:42 +00001402 <
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001403 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value && !__is_same_uncvref<_Tp, basic_string>::value,
Marshall Clow82513342016-09-24 22:45:42 +00001404 int
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001405 >
Marshall Clow82513342016-09-24 22:45:42 +00001406 compare(size_type __pos1, size_type __n1, const _Tp& __t, size_type __pos2, size_type __n2=npos) const;
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001407 _LIBCPP_CONSTEXPR_AFTER_CXX17 int compare(const value_type* __s) const _NOEXCEPT;
1408 _LIBCPP_CONSTEXPR_AFTER_CXX17 int compare(size_type __pos1, size_type __n1, const value_type* __s) const;
1409 _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantd17880b2013-06-28 16:59:19 +00001410 int compare(size_type __pos1, size_type __n1, const value_type* __s, size_type __n2) const;
Howard Hinnantc51e1022010-05-11 19:42:16 +00001411
Marshall Clow18c293b2017-12-04 20:11:38 +00001412#if _LIBCPP_STD_VER > 17
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001413 constexpr _LIBCPP_HIDE_FROM_ABI
Arthur O'Dwyera0cb1e82021-09-28 12:19:35 -04001414 bool starts_with(__self_view __sv) const noexcept
Marshall Clow18c293b2017-12-04 20:11:38 +00001415 { return __self_view(data(), size()).starts_with(__sv); }
1416
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001417 constexpr _LIBCPP_HIDE_FROM_ABI
Arthur O'Dwyera0cb1e82021-09-28 12:19:35 -04001418 bool starts_with(value_type __c) const noexcept
Marshall Clow18c293b2017-12-04 20:11:38 +00001419 { return !empty() && _Traits::eq(front(), __c); }
1420
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001421 constexpr _LIBCPP_HIDE_FROM_ABI
Arthur O'Dwyera0cb1e82021-09-28 12:19:35 -04001422 bool starts_with(const value_type* __s) const noexcept
Marshall Clow18c293b2017-12-04 20:11:38 +00001423 { return starts_with(__self_view(__s)); }
1424
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001425 constexpr _LIBCPP_HIDE_FROM_ABI
Arthur O'Dwyera0cb1e82021-09-28 12:19:35 -04001426 bool ends_with(__self_view __sv) const noexcept
Marshall Clow18c293b2017-12-04 20:11:38 +00001427 { return __self_view(data(), size()).ends_with( __sv); }
1428
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001429 constexpr _LIBCPP_HIDE_FROM_ABI
Arthur O'Dwyera0cb1e82021-09-28 12:19:35 -04001430 bool ends_with(value_type __c) const noexcept
Marshall Clow18c293b2017-12-04 20:11:38 +00001431 { return !empty() && _Traits::eq(back(), __c); }
1432
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001433 constexpr _LIBCPP_HIDE_FROM_ABI
Arthur O'Dwyera0cb1e82021-09-28 12:19:35 -04001434 bool ends_with(const value_type* __s) const noexcept
Marshall Clow18c293b2017-12-04 20:11:38 +00001435 { return ends_with(__self_view(__s)); }
1436#endif
1437
Wim Leflere023c3542021-01-19 14:33:30 -05001438#if _LIBCPP_STD_VER > 20
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001439 constexpr _LIBCPP_HIDE_FROM_ABI
Wim Leflere023c3542021-01-19 14:33:30 -05001440 bool contains(__self_view __sv) const noexcept
1441 { return __self_view(data(), size()).contains(__sv); }
1442
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001443 constexpr _LIBCPP_HIDE_FROM_ABI
Wim Leflere023c3542021-01-19 14:33:30 -05001444 bool contains(value_type __c) const noexcept
1445 { return __self_view(data(), size()).contains(__c); }
1446
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001447 constexpr _LIBCPP_HIDE_FROM_ABI
Wim Leflere023c3542021-01-19 14:33:30 -05001448 bool contains(const value_type* __s) const
1449 { return __self_view(data(), size()).contains(__s); }
1450#endif
1451
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001452 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17 bool __invariants() const;
Howard Hinnantaaeb1132013-04-22 23:55:13 +00001453
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001454 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17 void __clear_and_shrink() _NOEXCEPT;
Howard Hinnantaaeb1132013-04-22 23:55:13 +00001455
Louis Dionne510450b2022-04-01 16:38:30 -04001456#ifdef _LIBCPP_ENABLE_DEBUG_MODE
Howard Hinnant8ea98242013-08-23 17:37:05 +00001457
1458 bool __dereferenceable(const const_iterator* __i) const;
1459 bool __decrementable(const const_iterator* __i) const;
1460 bool __addable(const const_iterator* __i, ptrdiff_t __n) const;
1461 bool __subscriptable(const const_iterator* __i, ptrdiff_t __n) const;
1462
Louis Dionne510450b2022-04-01 16:38:30 -04001463#endif // _LIBCPP_ENABLE_DEBUG_MODE
Howard Hinnant8ea98242013-08-23 17:37:05 +00001464
Howard Hinnantc51e1022010-05-11 19:42:16 +00001465private:
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001466 template<class _Alloc>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001467 inline _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001468 bool friend operator==(const basic_string<char, char_traits<char>, _Alloc>& __lhs,
1469 const basic_string<char, char_traits<char>, _Alloc>& __rhs) _NOEXCEPT;
1470
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001471 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17 void __shrink_or_extend(size_type __target_capacity);
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001472
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001473 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001474 bool __is_long() const _NOEXCEPT {
1475 if (__libcpp_is_constant_evaluated())
1476 return true;
1477 return __r_.first().__s.__is_long_;
1478 }
1479
1480 static _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17 void __begin_lifetime(pointer __begin, size_type __n) {
1481#if _LIBCPP_STD_VER > 17
1482 if (__libcpp_is_constant_evaluated()) {
1483 for (size_type __i = 0; __i != __n; ++__i)
1484 std::construct_at(std::addressof(__begin[__i]));
1485 }
1486#else
1487 (void)__begin;
1488 (void)__n;
1489#endif // _LIBCPP_STD_VER > 17
1490 }
1491
1492 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17 void __default_init() {
1493 __zero();
1494 if (__libcpp_is_constant_evaluated()) {
1495 size_type __sz = __recommend(0) + 1;
1496 pointer __ptr = __alloc_traits::allocate(__alloc(), __sz);
1497 __begin_lifetime(__ptr, __sz);
1498 __set_long_pointer(__ptr);
1499 __set_long_cap(__sz);
1500 __set_long_size(0);
1501 }
1502 }
1503
1504 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17 void __deallocate_constexpr() {
1505 if (__libcpp_is_constant_evaluated() && __get_pointer() != nullptr)
1506 __alloc_traits::deallocate(__alloc(), __get_pointer(), __get_long_cap());
1507 }
1508
Nikolas Klauser93826d12022-01-04 17:24:03 +01001509 _LIBCPP_CONSTEXPR _LIBCPP_HIDE_FROM_ABI static bool __fits_in_sso(size_type __sz) {
1510 // SSO is disabled during constant evaluation because `__is_long` isn't constexpr friendly
1511 return !__libcpp_is_constant_evaluated() && (__sz < __min_cap);
1512 }
1513
Nikolas Klauser48d680d2022-02-26 13:28:33 +01001514 template <class _ForwardIterator>
1515 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX11
1516 iterator __insert_from_safe_copy(size_type __n, size_type __ip, _ForwardIterator __first, _ForwardIterator __last) {
1517 size_type __sz = size();
1518 size_type __cap = capacity();
1519 value_type* __p;
1520 if (__cap - __sz >= __n)
1521 {
1522 __p = std::__to_address(__get_pointer());
1523 size_type __n_move = __sz - __ip;
1524 if (__n_move != 0)
1525 traits_type::move(__p + __ip + __n, __p + __ip, __n_move);
1526 }
1527 else
1528 {
1529 __grow_by(__cap, __sz + __n - __cap, __sz, __ip, 0, __n);
1530 __p = std::__to_address(__get_long_pointer());
1531 }
1532 __sz += __n;
1533 __set_size(__sz);
1534 traits_type::assign(__p[__sz], value_type());
1535 for (__p += __ip; __first != __last; ++__p, ++__first)
1536 traits_type::assign(*__p, *__first);
1537
1538 return begin() + __ip;
1539 }
1540
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001541 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX11 allocator_type& __alloc() _NOEXCEPT { return __r_.second(); }
1542 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR const allocator_type& __alloc() const _NOEXCEPT { return __r_.second(); }
Howard Hinnantc51e1022010-05-11 19:42:16 +00001543
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001544 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Nikolas Klauser62060be2022-04-20 10:52:04 +02001545 void __set_short_size(size_type __s) _NOEXCEPT {
1546 _LIBCPP_ASSERT(__s < __min_cap, "__s should never be greater than or equal to the short string capacity");
1547 __r_.first().__s.__size_ = __s;
1548 __r_.first().__s.__is_long_ = false;
1549 }
Howard Hinnant68bf1812013-04-30 21:44:48 +00001550
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001551 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Nikolas Klauser62060be2022-04-20 10:52:04 +02001552 size_type __get_short_size() const _NOEXCEPT {
1553 _LIBCPP_ASSERT(!__r_.first().__s.__is_long_, "String has to be short when trying to get the short size");
1554 return __r_.first().__s.__size_;
1555 }
Howard Hinnant68bf1812013-04-30 21:44:48 +00001556
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001557 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001558 void __set_long_size(size_type __s) _NOEXCEPT
1559 {__r_.first().__l.__size_ = __s;}
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001560 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001561 size_type __get_long_size() const _NOEXCEPT
1562 {return __r_.first().__l.__size_;}
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001563 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001564 void __set_size(size_type __s) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00001565 {if (__is_long()) __set_long_size(__s); else __set_short_size(__s);}
1566
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001567 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Nikolas Klauser62060be2022-04-20 10:52:04 +02001568 void __set_long_cap(size_type __s) _NOEXCEPT {
1569 __r_.first().__l.__cap_ = __s / __endian_factor;
1570 __r_.first().__l.__is_long_ = true;
1571 }
1572
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001573 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Nikolas Klauser62060be2022-04-20 10:52:04 +02001574 size_type __get_long_cap() const _NOEXCEPT {
1575 return __r_.first().__l.__cap_ * __endian_factor;
1576 }
Howard Hinnantc51e1022010-05-11 19:42:16 +00001577
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001578 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001579 void __set_long_pointer(pointer __p) _NOEXCEPT
1580 {__r_.first().__l.__data_ = __p;}
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001581 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001582 pointer __get_long_pointer() _NOEXCEPT
1583 {return __r_.first().__l.__data_;}
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001584 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001585 const_pointer __get_long_pointer() const _NOEXCEPT
1586 {return __r_.first().__l.__data_;}
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001587 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001588 pointer __get_short_pointer() _NOEXCEPT
Howard Hinnantd17880b2013-06-28 16:59:19 +00001589 {return pointer_traits<pointer>::pointer_to(__r_.first().__s.__data_[0]);}
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001590 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001591 const_pointer __get_short_pointer() const _NOEXCEPT
Howard Hinnantd17880b2013-06-28 16:59:19 +00001592 {return pointer_traits<const_pointer>::pointer_to(__r_.first().__s.__data_[0]);}
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001593 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001594 pointer __get_pointer() _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00001595 {return __is_long() ? __get_long_pointer() : __get_short_pointer();}
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001596 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001597 const_pointer __get_pointer() const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00001598 {return __is_long() ? __get_long_pointer() : __get_short_pointer();}
1599
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001600 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001601 void __zero() _NOEXCEPT {
1602 __r_.first() = __rep();
1603 }
Howard Hinnantc51e1022010-05-11 19:42:16 +00001604
1605 template <size_type __a> static
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001606 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantea382952013-08-14 18:00:20 +00001607 size_type __align_it(size_type __s) _NOEXCEPT
Eric Fiselier8599fcc2015-08-28 07:02:42 +00001608 {return (__s + (__a-1)) & ~(__a-1);}
Howard Hinnantc51e1022010-05-11 19:42:16 +00001609 enum {__alignment = 16};
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001610 static _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantaeb17d82011-05-29 19:57:12 +00001611 size_type __recommend(size_type __s) _NOEXCEPT
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001612 {
1613 if (__s < __min_cap) {
1614 if (__libcpp_is_constant_evaluated())
1615 return static_cast<size_type>(__min_cap);
1616 else
1617 return static_cast<size_type>(__min_cap) - 1;
1618 }
Marshall Clow80584522018-02-07 21:30:17 +00001619 size_type __guess = __align_it<sizeof(value_type) < __alignment ?
1620 __alignment/sizeof(value_type) : 1 > (__s+1) - 1;
1621 if (__guess == __min_cap) ++__guess;
1622 return __guess;
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001623 }
Howard Hinnantc51e1022010-05-11 19:42:16 +00001624
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001625 inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantd17880b2013-06-28 16:59:19 +00001626 void __init(const value_type* __s, size_type __sz, size_type __reserve);
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001627 inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantd17880b2013-06-28 16:59:19 +00001628 void __init(const value_type* __s, size_type __sz);
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001629 inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00001630 void __init(size_type __n, value_type __c);
Howard Hinnant3b6579a2010-08-22 00:02:43 +00001631
Martijn Vels5e7c9752020-03-04 17:52:46 -05001632 // Slow path for the (inlined) copy constructor for 'long' strings.
1633 // Always externally instantiated and not inlined.
1634 // Requires that __s is zero terminated.
1635 // The main reason for this function to exist is because for unstable, we
1636 // want to allow inlining of the copy constructor. However, we don't want
1637 // to call the __init() functions as those are marked as inline which may
1638 // result in over-aggressive inlining by the compiler, where our aim is
1639 // to only inline the fast path code directly in the ctor.
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001640 _LIBCPP_CONSTEXPR_AFTER_CXX17 void __init_copy_ctor_external(const value_type* __s, size_type __sz);
Martijn Vels5e7c9752020-03-04 17:52:46 -05001641
Howard Hinnantc51e1022010-05-11 19:42:16 +00001642 template <class _InputIterator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001643 inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04001644 __enable_if_t
Howard Hinnantc51e1022010-05-11 19:42:16 +00001645 <
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001646 __is_exactly_cpp17_input_iterator<_InputIterator>::value
1647 >
Howard Hinnantc51e1022010-05-11 19:42:16 +00001648 __init(_InputIterator __first, _InputIterator __last);
1649
1650 template <class _ForwardIterator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001651 inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04001652 __enable_if_t
Howard Hinnantc51e1022010-05-11 19:42:16 +00001653 <
Eric Fiselierc522ceb2020-01-15 16:57:08 -05001654 __is_cpp17_forward_iterator<_ForwardIterator>::value
1655 >
Howard Hinnantc51e1022010-05-11 19:42:16 +00001656 __init(_ForwardIterator __first, _ForwardIterator __last);
1657
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001658 _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00001659 void __grow_by(size_type __old_cap, size_type __delta_cap, size_type __old_sz,
Howard Hinnant3b6579a2010-08-22 00:02:43 +00001660 size_type __n_copy, size_type __n_del, size_type __n_add = 0);
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001661 _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00001662 void __grow_by_and_replace(size_type __old_cap, size_type __delta_cap, size_type __old_sz,
1663 size_type __n_copy, size_type __n_del,
Howard Hinnantd17880b2013-06-28 16:59:19 +00001664 size_type __n_add, const value_type* __p_new_stuff);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001665
Martijn Vels596e3de2020-02-26 15:55:49 -05001666 // __assign_no_alias is invoked for assignment operations where we
1667 // have proof that the input does not alias the current instance.
1668 // For example, operator=(basic_string) performs a 'self' check.
1669 template <bool __is_short>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001670 _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string& __assign_no_alias(const value_type* __s, size_type __n);
Martijn Vels596e3de2020-02-26 15:55:49 -05001671
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001672 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00001673 void __erase_to_end(size_type __pos);
1674
Martijn Velsa81fc792020-02-26 13:25:43 -05001675 // __erase_external_with_move is invoked for erase() invocations where
1676 // `n ~= npos`, likely requiring memory moves on the string data.
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001677 _LIBCPP_CONSTEXPR_AFTER_CXX17 void __erase_external_with_move(size_type __pos, size_type __n);
Martijn Velsa81fc792020-02-26 13:25:43 -05001678
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001679 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantea8f7e12010-11-17 17:55:08 +00001680 void __copy_assign_alloc(const basic_string& __str)
1681 {__copy_assign_alloc(__str, integral_constant<bool,
1682 __alloc_traits::propagate_on_container_copy_assignment::value>());}
1683
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001684 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantea8f7e12010-11-17 17:55:08 +00001685 void __copy_assign_alloc(const basic_string& __str, true_type)
1686 {
Marshall Clowf258c202017-01-31 03:40:52 +00001687 if (__alloc() == __str.__alloc())
1688 __alloc() = __str.__alloc();
1689 else
Howard Hinnantea8f7e12010-11-17 17:55:08 +00001690 {
Marshall Clowf258c202017-01-31 03:40:52 +00001691 if (!__str.__is_long())
1692 {
Vedant Kumar55e007e2018-03-08 21:15:26 +00001693 __clear_and_shrink();
Marshall Clowf258c202017-01-31 03:40:52 +00001694 __alloc() = __str.__alloc();
1695 }
1696 else
1697 {
1698 allocator_type __a = __str.__alloc();
Nikolas Klauserc513eba2022-04-09 09:41:19 +02001699 auto __allocation = std::__allocate_at_least(__a, __str.__get_long_cap());
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001700 __begin_lifetime(__allocation.ptr, __allocation.count);
Vedant Kumar55e007e2018-03-08 21:15:26 +00001701 __clear_and_shrink();
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001702 __alloc() = std::move(__a);
Nikolas Klauserc513eba2022-04-09 09:41:19 +02001703 __set_long_pointer(__allocation.ptr);
1704 __set_long_cap(__allocation.count);
Marshall Clowf258c202017-01-31 03:40:52 +00001705 __set_long_size(__str.size());
1706 }
Howard Hinnantea8f7e12010-11-17 17:55:08 +00001707 }
Howard Hinnantea8f7e12010-11-17 17:55:08 +00001708 }
1709
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001710 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnant28b24882011-12-01 20:21:04 +00001711 void __copy_assign_alloc(const basic_string&, false_type) _NOEXCEPT
Howard Hinnantea8f7e12010-11-17 17:55:08 +00001712 {}
1713
Eric Fiselierfc92be82017-04-19 00:28:44 +00001714#ifndef _LIBCPP_CXX03_LANG
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001715 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Marshall Clow2fe8a8d2015-08-18 18:57:00 +00001716 void __move_assign(basic_string& __str, false_type)
1717 _NOEXCEPT_(__alloc_traits::is_always_equal::value);
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001718 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnant3e276872011-06-03 18:40:47 +00001719 void __move_assign(basic_string& __str, true_type)
Marshall Clow2fe8a8d2015-08-18 18:57:00 +00001720#if _LIBCPP_STD_VER > 14
1721 _NOEXCEPT;
1722#else
Howard Hinnant3e276872011-06-03 18:40:47 +00001723 _NOEXCEPT_(is_nothrow_move_assignable<allocator_type>::value);
Howard Hinnantea8f7e12010-11-17 17:55:08 +00001724#endif
Marshall Clow2fe8a8d2015-08-18 18:57:00 +00001725#endif
Howard Hinnantea8f7e12010-11-17 17:55:08 +00001726
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001727 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnant58fe91b2011-08-17 20:36:18 +00001728 void
Howard Hinnantc2734962011-09-02 20:42:31 +00001729 __move_assign_alloc(basic_string& __str)
Howard Hinnant58fe91b2011-08-17 20:36:18 +00001730 _NOEXCEPT_(
1731 !__alloc_traits::propagate_on_container_move_assignment::value ||
1732 is_nothrow_move_assignable<allocator_type>::value)
1733 {__move_assign_alloc(__str, integral_constant<bool,
1734 __alloc_traits::propagate_on_container_move_assignment::value>());}
1735
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001736 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc2734962011-09-02 20:42:31 +00001737 void __move_assign_alloc(basic_string& __c, true_type)
Howard Hinnant58fe91b2011-08-17 20:36:18 +00001738 _NOEXCEPT_(is_nothrow_move_assignable<allocator_type>::value)
1739 {
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001740 __alloc() = std::move(__c.__alloc());
Howard Hinnant58fe91b2011-08-17 20:36:18 +00001741 }
1742
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001743 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnant28b24882011-12-01 20:21:04 +00001744 void __move_assign_alloc(basic_string&, false_type)
Howard Hinnant58fe91b2011-08-17 20:36:18 +00001745 _NOEXCEPT
1746 {}
1747
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001748 _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string& __assign_external(const value_type* __s);
1749 _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string& __assign_external(const value_type* __s, size_type __n);
Martijn Velsda7d94f2020-06-19 14:24:03 -04001750
1751 // Assigns the value in __s, guaranteed to be __n < __min_cap in length.
1752 inline basic_string& __assign_short(const value_type* __s, size_type __n) {
1753 pointer __p = __is_long()
1754 ? (__set_long_size(__n), __get_long_pointer())
1755 : (__set_short_size(__n), __get_short_pointer());
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001756 traits_type::move(std::__to_address(__p), __s, __n);
Martijn Velsda7d94f2020-06-19 14:24:03 -04001757 traits_type::assign(__p[__n], value_type());
1758 return *this;
1759 }
1760
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001761 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
1762 basic_string& __null_terminate_at(value_type* __p, size_type __newsz) {
Nikolas Klauser3ec7fb22021-12-14 01:20:53 +01001763 __set_size(__newsz);
1764 __invalidate_iterators_past(__newsz);
1765 traits_type::assign(__p[__newsz], value_type());
1766 return *this;
1767 }
1768
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001769 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17 void __invalidate_iterators_past(size_type);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001770
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04001771 template<class _Tp>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001772 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04001773 bool __addr_in_range(_Tp&& __t) const {
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001774 // assume that the ranges overlap, because we can't check during constant evaluation
1775 if (__libcpp_is_constant_evaluated())
1776 return true;
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001777 const volatile void *__p = std::addressof(__t);
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04001778 return data() <= __p && __p <= data() + size();
1779 }
1780
Louis Dionned24191c2021-08-19 12:39:16 -04001781 _LIBCPP_NORETURN _LIBCPP_HIDE_FROM_ABI
1782 void __throw_length_error() const {
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001783 std::__throw_length_error("basic_string");
Louis Dionned24191c2021-08-19 12:39:16 -04001784 }
1785
1786 _LIBCPP_NORETURN _LIBCPP_HIDE_FROM_ABI
1787 void __throw_out_of_range() const {
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001788 std::__throw_out_of_range("basic_string");
Louis Dionned24191c2021-08-19 12:39:16 -04001789 }
1790
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001791 friend _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string operator+<>(const basic_string&, const basic_string&);
1792 friend _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string operator+<>(const value_type*, const basic_string&);
1793 friend _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string operator+<>(value_type, const basic_string&);
1794 friend _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string operator+<>(const basic_string&, const value_type*);
1795 friend _LIBCPP_CONSTEXPR_AFTER_CXX17 basic_string operator+<>(const basic_string&, value_type);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001796};
1797
Eric Fiselier2ed640b2020-03-04 13:54:04 -05001798// These declarations must appear before any functions are implicitly used
1799// so that they have the correct visibility specifier.
Louis Dionnedc496ec2021-06-08 17:25:08 -04001800#define _LIBCPP_DECLARE(...) extern template __VA_ARGS__;
Eric Fiselier2ed640b2020-03-04 13:54:04 -05001801#ifdef _LIBCPP_ABI_STRING_OPTIMIZED_EXTERNAL_INSTANTIATION
Louis Dionnedc496ec2021-06-08 17:25:08 -04001802 _LIBCPP_STRING_UNSTABLE_EXTERN_TEMPLATE_LIST(_LIBCPP_DECLARE, char)
Louis Dionne89258142021-08-23 15:32:36 -04001803# ifndef _LIBCPP_HAS_NO_WIDE_CHARACTERS
Louis Dionnedc496ec2021-06-08 17:25:08 -04001804 _LIBCPP_STRING_UNSTABLE_EXTERN_TEMPLATE_LIST(_LIBCPP_DECLARE, wchar_t)
Louis Dionne89258142021-08-23 15:32:36 -04001805# endif
Eric Fiselier2ed640b2020-03-04 13:54:04 -05001806#else
Louis Dionnedc496ec2021-06-08 17:25:08 -04001807 _LIBCPP_STRING_V1_EXTERN_TEMPLATE_LIST(_LIBCPP_DECLARE, char)
Louis Dionne89258142021-08-23 15:32:36 -04001808# ifndef _LIBCPP_HAS_NO_WIDE_CHARACTERS
Louis Dionnedc496ec2021-06-08 17:25:08 -04001809 _LIBCPP_STRING_V1_EXTERN_TEMPLATE_LIST(_LIBCPP_DECLARE, wchar_t)
Louis Dionne89258142021-08-23 15:32:36 -04001810# endif
Eric Fiselier2ed640b2020-03-04 13:54:04 -05001811#endif
Louis Dionnedc496ec2021-06-08 17:25:08 -04001812#undef _LIBCPP_DECLARE
Eric Fiselier2ed640b2020-03-04 13:54:04 -05001813
1814
Louis Dionned59f8a52021-08-17 11:59:07 -04001815#if _LIBCPP_STD_VER >= 17
Marshall Clowa0563332018-02-08 06:34:03 +00001816template<class _InputIterator,
Arthur O'Dwyer56226762021-03-03 23:02:20 -05001817 class _CharT = __iter_value_type<_InputIterator>,
Marshall Clowa0563332018-02-08 06:34:03 +00001818 class _Allocator = allocator<_CharT>,
Louis Dionne25547162021-08-17 12:26:09 -04001819 class = enable_if_t<__is_cpp17_input_iterator<_InputIterator>::value>,
1820 class = enable_if_t<__is_allocator<_Allocator>::value>
Marshall Clowa0563332018-02-08 06:34:03 +00001821 >
1822basic_string(_InputIterator, _InputIterator, _Allocator = _Allocator())
1823 -> basic_string<_CharT, char_traits<_CharT>, _Allocator>;
Marshall Clowe46031a2018-07-02 18:41:15 +00001824
1825template<class _CharT,
1826 class _Traits,
1827 class _Allocator = allocator<_CharT>,
Louis Dionne25547162021-08-17 12:26:09 -04001828 class = enable_if_t<__is_allocator<_Allocator>::value>
Marshall Clowe46031a2018-07-02 18:41:15 +00001829 >
1830explicit basic_string(basic_string_view<_CharT, _Traits>, const _Allocator& = _Allocator())
1831 -> basic_string<_CharT, _Traits, _Allocator>;
1832
1833template<class _CharT,
1834 class _Traits,
1835 class _Allocator = allocator<_CharT>,
Louis Dionne25547162021-08-17 12:26:09 -04001836 class = enable_if_t<__is_allocator<_Allocator>::value>,
Marshall Clowe46031a2018-07-02 18:41:15 +00001837 class _Sz = typename allocator_traits<_Allocator>::size_type
1838 >
1839basic_string(basic_string_view<_CharT, _Traits>, _Sz, _Sz, const _Allocator& = _Allocator())
1840 -> basic_string<_CharT, _Traits, _Allocator>;
Marshall Clowa0563332018-02-08 06:34:03 +00001841#endif
1842
Howard Hinnantc51e1022010-05-11 19:42:16 +00001843template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001844inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00001845void
Arthur O'Dwyerb3db4542021-04-27 09:10:04 -04001846basic_string<_CharT, _Traits, _Allocator>::__invalidate_iterators_past(size_type __pos)
Howard Hinnantc51e1022010-05-11 19:42:16 +00001847{
Louis Dionne510450b2022-04-01 16:38:30 -04001848#ifdef _LIBCPP_ENABLE_DEBUG_MODE
Nikolas Klauser1a7d9f02021-12-16 14:55:03 +01001849 if (!__libcpp_is_constant_evaluated()) {
1850 __c_node* __c = __get_db()->__find_c_and_lock(this);
1851 if (__c)
Howard Hinnantc51e1022010-05-11 19:42:16 +00001852 {
Nikolas Klauser1a7d9f02021-12-16 14:55:03 +01001853 const_pointer __new_last = __get_pointer() + __pos;
1854 for (__i_node** __p = __c->end_; __p != __c->beg_; )
Howard Hinnantc51e1022010-05-11 19:42:16 +00001855 {
Nikolas Klauser1a7d9f02021-12-16 14:55:03 +01001856 --__p;
1857 const_iterator* __i = static_cast<const_iterator*>((*__p)->__i_);
1858 if (__i->base() > __new_last)
1859 {
1860 (*__p)->__c_ = nullptr;
1861 if (--__c->end_ != __p)
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001862 std::memmove(__p, __p+1, (__c->end_ - __p)*sizeof(__i_node*));
Nikolas Klauser1a7d9f02021-12-16 14:55:03 +01001863 }
Howard Hinnantc51e1022010-05-11 19:42:16 +00001864 }
Nikolas Klauser1a7d9f02021-12-16 14:55:03 +01001865 __get_db()->unlock();
Howard Hinnantc51e1022010-05-11 19:42:16 +00001866 }
1867 }
Arthur O'Dwyerb3db4542021-04-27 09:10:04 -04001868#else
1869 (void)__pos;
Louis Dionne510450b2022-04-01 16:38:30 -04001870#endif // _LIBCPP_ENABLE_DEBUG_MODE
Howard Hinnantc51e1022010-05-11 19:42:16 +00001871}
1872
1873template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001874inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnant3e276872011-06-03 18:40:47 +00001875basic_string<_CharT, _Traits, _Allocator>::basic_string()
Marshall Clowe546cbb2015-06-04 02:05:41 +00001876 _NOEXCEPT_(is_nothrow_default_constructible<allocator_type>::value)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05001877 : __r_(__default_init_tag(), __default_init_tag())
Howard Hinnantc51e1022010-05-11 19:42:16 +00001878{
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001879 std::__debug_db_insert_c(this);
1880 __default_init();
Howard Hinnantc51e1022010-05-11 19:42:16 +00001881}
1882
1883template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001884inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00001885basic_string<_CharT, _Traits, _Allocator>::basic_string(const allocator_type& __a)
Eric Fiseliere012bf22015-07-18 20:40:46 +00001886#if _LIBCPP_STD_VER <= 14
1887 _NOEXCEPT_(is_nothrow_copy_constructible<allocator_type>::value)
1888#else
1889 _NOEXCEPT
1890#endif
Eric Fiselier5169d1c2019-12-16 19:03:23 -05001891: __r_(__default_init_tag(), __a)
Howard Hinnantc51e1022010-05-11 19:42:16 +00001892{
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001893 std::__debug_db_insert_c(this);
1894 __default_init();
Howard Hinnantc51e1022010-05-11 19:42:16 +00001895}
1896
1897template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001898_LIBCPP_CONSTEXPR_AFTER_CXX17
Eric Fiselier815ed732016-09-16 00:00:48 +00001899void basic_string<_CharT, _Traits, _Allocator>::__init(const value_type* __s,
1900 size_type __sz,
1901 size_type __reserve)
Howard Hinnantc51e1022010-05-11 19:42:16 +00001902{
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001903 if (__libcpp_is_constant_evaluated())
1904 __zero();
Howard Hinnantc51e1022010-05-11 19:42:16 +00001905 if (__reserve > max_size())
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01001906 __throw_length_error();
Howard Hinnantc51e1022010-05-11 19:42:16 +00001907 pointer __p;
Nikolas Klauser93826d12022-01-04 17:24:03 +01001908 if (__fits_in_sso(__reserve))
Howard Hinnantc51e1022010-05-11 19:42:16 +00001909 {
1910 __set_short_size(__sz);
1911 __p = __get_short_pointer();
1912 }
1913 else
1914 {
Nikolas Klauserc513eba2022-04-09 09:41:19 +02001915 auto __allocation = std::__allocate_at_least(__alloc(), __recommend(__reserve) + 1);
1916 __p = __allocation.ptr;
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001917 __begin_lifetime(__p, __allocation.count);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001918 __set_long_pointer(__p);
Nikolas Klauserc513eba2022-04-09 09:41:19 +02001919 __set_long_cap(__allocation.count);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001920 __set_long_size(__sz);
1921 }
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001922 traits_type::copy(std::__to_address(__p), __s, __sz);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001923 traits_type::assign(__p[__sz], value_type());
1924}
1925
1926template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001927_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00001928void
Howard Hinnantd17880b2013-06-28 16:59:19 +00001929basic_string<_CharT, _Traits, _Allocator>::__init(const value_type* __s, size_type __sz)
Howard Hinnantc51e1022010-05-11 19:42:16 +00001930{
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001931 if (__libcpp_is_constant_evaluated())
1932 __zero();
Howard Hinnantc51e1022010-05-11 19:42:16 +00001933 if (__sz > max_size())
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01001934 __throw_length_error();
Howard Hinnantc51e1022010-05-11 19:42:16 +00001935 pointer __p;
Nikolas Klauser93826d12022-01-04 17:24:03 +01001936 if (__fits_in_sso(__sz))
Howard Hinnantc51e1022010-05-11 19:42:16 +00001937 {
1938 __set_short_size(__sz);
1939 __p = __get_short_pointer();
1940 }
1941 else
1942 {
Nikolas Klauserc513eba2022-04-09 09:41:19 +02001943 auto __allocation = std::__allocate_at_least(__alloc(), __recommend(__sz) + 1);
1944 __p = __allocation.ptr;
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001945 __begin_lifetime(__p, __allocation.count);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001946 __set_long_pointer(__p);
Nikolas Klauserc513eba2022-04-09 09:41:19 +02001947 __set_long_cap(__allocation.count);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001948 __set_long_size(__sz);
1949 }
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001950 traits_type::copy(std::__to_address(__p), __s, __sz);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001951 traits_type::assign(__p[__sz], value_type());
1952}
1953
1954template <class _CharT, class _Traits, class _Allocator>
Marshall Clowe46031a2018-07-02 18:41:15 +00001955template <class>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001956_LIBCPP_CONSTEXPR_AFTER_CXX17
Eric Fiselier812882b2017-02-17 01:17:10 +00001957basic_string<_CharT, _Traits, _Allocator>::basic_string(const _CharT* __s, const _Allocator& __a)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05001958 : __r_(__default_init_tag(), __a)
Howard Hinnantc51e1022010-05-11 19:42:16 +00001959{
Howard Hinnant8ea98242013-08-23 17:37:05 +00001960 _LIBCPP_ASSERT(__s != nullptr, "basic_string(const char*, allocator) detected nullptr");
Howard Hinnantc51e1022010-05-11 19:42:16 +00001961 __init(__s, traits_type::length(__s));
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001962 std::__debug_db_insert_c(this);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001963}
1964
1965template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001966inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Eric Fiselier812882b2017-02-17 01:17:10 +00001967basic_string<_CharT, _Traits, _Allocator>::basic_string(const _CharT* __s, size_type __n)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05001968 : __r_(__default_init_tag(), __default_init_tag())
Howard Hinnantc51e1022010-05-11 19:42:16 +00001969{
Nikolas Klauserf2807732022-01-11 00:33:35 +01001970 _LIBCPP_ASSERT(__n == 0 || __s != nullptr, "basic_string(const char*, n) detected nullptr");
1971 __init(__s, __n);
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001972 std::__debug_db_insert_c(this);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001973}
1974
1975template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001976inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Eric Fiselier812882b2017-02-17 01:17:10 +00001977basic_string<_CharT, _Traits, _Allocator>::basic_string(const _CharT* __s, size_type __n, const _Allocator& __a)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05001978 : __r_(__default_init_tag(), __a)
Howard Hinnantc51e1022010-05-11 19:42:16 +00001979{
Howard Hinnant8ea98242013-08-23 17:37:05 +00001980 _LIBCPP_ASSERT(__n == 0 || __s != nullptr, "basic_string(const char*, n, allocator) detected nullptr");
Howard Hinnantc51e1022010-05-11 19:42:16 +00001981 __init(__s, __n);
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001982 std::__debug_db_insert_c(this);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001983}
1984
1985template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001986_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00001987basic_string<_CharT, _Traits, _Allocator>::basic_string(const basic_string& __str)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05001988 : __r_(__default_init_tag(), __alloc_traits::select_on_container_copy_construction(__str.__alloc()))
Howard Hinnantc51e1022010-05-11 19:42:16 +00001989{
1990 if (!__str.__is_long())
1991 __r_.first().__r = __str.__r_.first().__r;
1992 else
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001993 __init_copy_ctor_external(std::__to_address(__str.__get_long_pointer()),
Martijn Vels5e7c9752020-03-04 17:52:46 -05001994 __str.__get_long_size());
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02001995 std::__debug_db_insert_c(this);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001996}
1997
1998template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02001999_LIBCPP_CONSTEXPR_AFTER_CXX17
Eric Fiselier812882b2017-02-17 01:17:10 +00002000basic_string<_CharT, _Traits, _Allocator>::basic_string(
2001 const basic_string& __str, const allocator_type& __a)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05002002 : __r_(__default_init_tag(), __a)
Howard Hinnantc51e1022010-05-11 19:42:16 +00002003{
2004 if (!__str.__is_long())
2005 __r_.first().__r = __str.__r_.first().__r;
2006 else
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002007 __init_copy_ctor_external(std::__to_address(__str.__get_long_pointer()),
Martijn Vels5e7c9752020-03-04 17:52:46 -05002008 __str.__get_long_size());
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002009 std::__debug_db_insert_c(this);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002010}
2011
Martijn Vels5e7c9752020-03-04 17:52:46 -05002012template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002013_LIBCPP_CONSTEXPR_AFTER_CXX17
Martijn Vels5e7c9752020-03-04 17:52:46 -05002014void basic_string<_CharT, _Traits, _Allocator>::__init_copy_ctor_external(
2015 const value_type* __s, size_type __sz) {
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002016 if (__libcpp_is_constant_evaluated())
2017 __zero();
Martijn Vels5e7c9752020-03-04 17:52:46 -05002018 pointer __p;
Nikolas Klauser93826d12022-01-04 17:24:03 +01002019 if (__fits_in_sso(__sz)) {
Martijn Vels5e7c9752020-03-04 17:52:46 -05002020 __p = __get_short_pointer();
2021 __set_short_size(__sz);
2022 } else {
2023 if (__sz > max_size())
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01002024 __throw_length_error();
Nikolas Klauserc513eba2022-04-09 09:41:19 +02002025 auto __allocation = std::__allocate_at_least(__alloc(), __recommend(__sz) + 1);
2026 __p = __allocation.ptr;
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002027 __begin_lifetime(__p, __allocation.count);
Martijn Vels5e7c9752020-03-04 17:52:46 -05002028 __set_long_pointer(__p);
Nikolas Klauserc513eba2022-04-09 09:41:19 +02002029 __set_long_cap(__allocation.count);
Martijn Vels5e7c9752020-03-04 17:52:46 -05002030 __set_long_size(__sz);
2031 }
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002032 traits_type::copy(std::__to_address(__p), __s, __sz + 1);
Martijn Vels5e7c9752020-03-04 17:52:46 -05002033}
2034
Eric Fiselierfc92be82017-04-19 00:28:44 +00002035#ifndef _LIBCPP_CXX03_LANG
Howard Hinnantc51e1022010-05-11 19:42:16 +00002036
2037template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002038inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnant3e276872011-06-03 18:40:47 +00002039basic_string<_CharT, _Traits, _Allocator>::basic_string(basic_string&& __str)
Marshall Clowa80abc72015-06-03 19:56:43 +00002040#if _LIBCPP_STD_VER <= 14
Howard Hinnant3e276872011-06-03 18:40:47 +00002041 _NOEXCEPT_(is_nothrow_move_constructible<allocator_type>::value)
Marshall Clowa80abc72015-06-03 19:56:43 +00002042#else
2043 _NOEXCEPT
2044#endif
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002045 : __r_(std::move(__str.__r_))
Howard Hinnantc51e1022010-05-11 19:42:16 +00002046{
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002047 __str.__default_init();
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002048 std::__debug_db_insert_c(this);
Nikolas Klauser98833542022-05-07 22:20:23 +02002049 if (__is_long())
2050 std::__debug_db_swap(this, &__str);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002051}
2052
2053template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002054inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00002055basic_string<_CharT, _Traits, _Allocator>::basic_string(basic_string&& __str, const allocator_type& __a)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05002056 : __r_(__default_init_tag(), __a)
Howard Hinnantc51e1022010-05-11 19:42:16 +00002057{
Marshall Clowd2d24692014-07-17 15:32:20 +00002058 if (__str.__is_long() && __a != __str.__alloc()) // copy, not move
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002059 __init(std::__to_address(__str.__get_long_pointer()), __str.__get_long_size());
Marshall Clowd2d24692014-07-17 15:32:20 +00002060 else
2061 {
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002062 if (__libcpp_is_constant_evaluated()) {
2063 __zero();
2064 __r_.first().__l = __str.__r_.first().__l;
2065 } else {
2066 __r_.first().__r = __str.__r_.first().__r;
2067 }
2068 __str.__default_init();
Marshall Clowd2d24692014-07-17 15:32:20 +00002069 }
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002070 std::__debug_db_insert_c(this);
Nikolas Klauser98833542022-05-07 22:20:23 +02002071 if (__is_long())
2072 std::__debug_db_swap(this, &__str);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002073}
2074
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04002075#endif // _LIBCPP_CXX03_LANG
Howard Hinnantc51e1022010-05-11 19:42:16 +00002076
2077template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002078_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00002079void
2080basic_string<_CharT, _Traits, _Allocator>::__init(size_type __n, value_type __c)
2081{
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002082 if (__libcpp_is_constant_evaluated())
2083 __zero();
Howard Hinnantc51e1022010-05-11 19:42:16 +00002084 if (__n > max_size())
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01002085 __throw_length_error();
Howard Hinnantc51e1022010-05-11 19:42:16 +00002086 pointer __p;
Nikolas Klauser93826d12022-01-04 17:24:03 +01002087 if (__fits_in_sso(__n))
Howard Hinnantc51e1022010-05-11 19:42:16 +00002088 {
2089 __set_short_size(__n);
2090 __p = __get_short_pointer();
2091 }
2092 else
2093 {
Nikolas Klauserc513eba2022-04-09 09:41:19 +02002094 auto __allocation = std::__allocate_at_least(__alloc(), __recommend(__n) + 1);
2095 __p = __allocation.ptr;
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002096 __begin_lifetime(__p, __allocation.count);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002097 __set_long_pointer(__p);
Nikolas Klauserc513eba2022-04-09 09:41:19 +02002098 __set_long_cap(__allocation.count);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002099 __set_long_size(__n);
2100 }
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002101 traits_type::assign(std::__to_address(__p), __n, __c);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002102 traits_type::assign(__p[__n], value_type());
2103}
2104
2105template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002106inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Eric Fiselier812882b2017-02-17 01:17:10 +00002107basic_string<_CharT, _Traits, _Allocator>::basic_string(size_type __n, _CharT __c)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05002108 : __r_(__default_init_tag(), __default_init_tag())
Howard Hinnantc51e1022010-05-11 19:42:16 +00002109{
2110 __init(__n, __c);
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002111 std::__debug_db_insert_c(this);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002112}
2113
2114template <class _CharT, class _Traits, class _Allocator>
Marshall Clowe46031a2018-07-02 18:41:15 +00002115template <class>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002116_LIBCPP_CONSTEXPR_AFTER_CXX17
Eric Fiselier812882b2017-02-17 01:17:10 +00002117basic_string<_CharT, _Traits, _Allocator>::basic_string(size_type __n, _CharT __c, const _Allocator& __a)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05002118 : __r_(__default_init_tag(), __a)
Howard Hinnantc51e1022010-05-11 19:42:16 +00002119{
2120 __init(__n, __c);
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002121 std::__debug_db_insert_c(this);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002122}
2123
Howard Hinnantc51e1022010-05-11 19:42:16 +00002124template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002125_LIBCPP_CONSTEXPR_AFTER_CXX17
Eric Fiselier812882b2017-02-17 01:17:10 +00002126basic_string<_CharT, _Traits, _Allocator>::basic_string(const basic_string& __str,
2127 size_type __pos, size_type __n,
2128 const _Allocator& __a)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05002129 : __r_(__default_init_tag(), __a)
Howard Hinnantc51e1022010-05-11 19:42:16 +00002130{
2131 size_type __str_sz = __str.size();
2132 if (__pos > __str_sz)
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01002133 __throw_out_of_range();
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002134 __init(__str.data() + __pos, std::min(__n, __str_sz - __pos));
2135 std::__debug_db_insert_c(this);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002136}
2137
2138template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002139inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Marshall Clow83445802016-04-07 18:13:41 +00002140basic_string<_CharT, _Traits, _Allocator>::basic_string(const basic_string& __str, size_type __pos,
Eric Fiselier812882b2017-02-17 01:17:10 +00002141 const _Allocator& __a)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05002142 : __r_(__default_init_tag(), __a)
Marshall Clow83445802016-04-07 18:13:41 +00002143{
2144 size_type __str_sz = __str.size();
2145 if (__pos > __str_sz)
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01002146 __throw_out_of_range();
Marshall Clow83445802016-04-07 18:13:41 +00002147 __init(__str.data() + __pos, __str_sz - __pos);
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002148 std::__debug_db_insert_c(this);
Marshall Clow83445802016-04-07 18:13:41 +00002149}
2150
2151template <class _CharT, class _Traits, class _Allocator>
Marshall Clowe46031a2018-07-02 18:41:15 +00002152template <class _Tp, class>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002153_LIBCPP_CONSTEXPR_AFTER_CXX17
Marshall Clow78dbe462016-11-14 18:22:19 +00002154basic_string<_CharT, _Traits, _Allocator>::basic_string(
Marshall Clowe46031a2018-07-02 18:41:15 +00002155 const _Tp& __t, size_type __pos, size_type __n, const allocator_type& __a)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05002156 : __r_(__default_init_tag(), __a)
Marshall Clow78dbe462016-11-14 18:22:19 +00002157{
Marshall Clowe46031a2018-07-02 18:41:15 +00002158 __self_view __sv0 = __t;
2159 __self_view __sv = __sv0.substr(__pos, __n);
Marshall Clow78dbe462016-11-14 18:22:19 +00002160 __init(__sv.data(), __sv.size());
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002161 std::__debug_db_insert_c(this);
Marshall Clow78dbe462016-11-14 18:22:19 +00002162}
2163
2164template <class _CharT, class _Traits, class _Allocator>
Marshall Clowe46031a2018-07-02 18:41:15 +00002165template <class _Tp, class>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002166_LIBCPP_CONSTEXPR_AFTER_CXX17
Marshall Clowe46031a2018-07-02 18:41:15 +00002167basic_string<_CharT, _Traits, _Allocator>::basic_string(const _Tp & __t)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05002168 : __r_(__default_init_tag(), __default_init_tag())
Marshall Clowdf63a6d2016-07-21 05:31:24 +00002169{
Marshall Clowe46031a2018-07-02 18:41:15 +00002170 __self_view __sv = __t;
Marshall Clowdf63a6d2016-07-21 05:31:24 +00002171 __init(__sv.data(), __sv.size());
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002172 std::__debug_db_insert_c(this);
Marshall Clowdf63a6d2016-07-21 05:31:24 +00002173}
2174
2175template <class _CharT, class _Traits, class _Allocator>
Marshall Clowe46031a2018-07-02 18:41:15 +00002176template <class _Tp, class>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002177_LIBCPP_CONSTEXPR_AFTER_CXX17
Marshall Clowe46031a2018-07-02 18:41:15 +00002178basic_string<_CharT, _Traits, _Allocator>::basic_string(const _Tp & __t, const _Allocator& __a)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05002179 : __r_(__default_init_tag(), __a)
Marshall Clowdf63a6d2016-07-21 05:31:24 +00002180{
Marshall Clowe46031a2018-07-02 18:41:15 +00002181 __self_view __sv = __t;
Marshall Clowdf63a6d2016-07-21 05:31:24 +00002182 __init(__sv.data(), __sv.size());
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002183 std::__debug_db_insert_c(this);
Marshall Clowdf63a6d2016-07-21 05:31:24 +00002184}
2185
2186template <class _CharT, class _Traits, class _Allocator>
Howard Hinnantc51e1022010-05-11 19:42:16 +00002187template <class _InputIterator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002188_LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04002189__enable_if_t
Howard Hinnantc51e1022010-05-11 19:42:16 +00002190<
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002191 __is_exactly_cpp17_input_iterator<_InputIterator>::value
2192>
Howard Hinnantc51e1022010-05-11 19:42:16 +00002193basic_string<_CharT, _Traits, _Allocator>::__init(_InputIterator __first, _InputIterator __last)
2194{
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002195 __default_init();
Howard Hinnantc51e1022010-05-11 19:42:16 +00002196#ifndef _LIBCPP_NO_EXCEPTIONS
2197 try
2198 {
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04002199#endif // _LIBCPP_NO_EXCEPTIONS
Howard Hinnantc51e1022010-05-11 19:42:16 +00002200 for (; __first != __last; ++__first)
2201 push_back(*__first);
2202#ifndef _LIBCPP_NO_EXCEPTIONS
2203 }
2204 catch (...)
2205 {
2206 if (__is_long())
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002207 __alloc_traits::deallocate(__alloc(), __get_long_pointer(), __get_long_cap());
Howard Hinnantc51e1022010-05-11 19:42:16 +00002208 throw;
2209 }
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04002210#endif // _LIBCPP_NO_EXCEPTIONS
Howard Hinnantc51e1022010-05-11 19:42:16 +00002211}
2212
2213template <class _CharT, class _Traits, class _Allocator>
2214template <class _ForwardIterator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002215_LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04002216__enable_if_t
Howard Hinnantc51e1022010-05-11 19:42:16 +00002217<
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002218 __is_cpp17_forward_iterator<_ForwardIterator>::value
2219>
Howard Hinnantc51e1022010-05-11 19:42:16 +00002220basic_string<_CharT, _Traits, _Allocator>::__init(_ForwardIterator __first, _ForwardIterator __last)
2221{
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002222 if (__libcpp_is_constant_evaluated())
2223 __zero();
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002224 size_type __sz = static_cast<size_type>(std::distance(__first, __last));
Howard Hinnantc51e1022010-05-11 19:42:16 +00002225 if (__sz > max_size())
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01002226 __throw_length_error();
Howard Hinnantc51e1022010-05-11 19:42:16 +00002227 pointer __p;
Nikolas Klauser93826d12022-01-04 17:24:03 +01002228 if (__fits_in_sso(__sz))
Howard Hinnantc51e1022010-05-11 19:42:16 +00002229 {
2230 __set_short_size(__sz);
2231 __p = __get_short_pointer();
2232 }
2233 else
2234 {
Nikolas Klauserc513eba2022-04-09 09:41:19 +02002235 auto __allocation = std::__allocate_at_least(__alloc(), __recommend(__sz) + 1);
2236 __p = __allocation.ptr;
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002237 __begin_lifetime(__p, __allocation.count);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002238 __set_long_pointer(__p);
Nikolas Klauserc513eba2022-04-09 09:41:19 +02002239 __set_long_cap(__allocation.count);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002240 __set_long_size(__sz);
2241 }
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04002242
2243#ifndef _LIBCPP_NO_EXCEPTIONS
2244 try
2245 {
2246#endif // _LIBCPP_NO_EXCEPTIONS
Eric Fiseliera09a3b42014-10-27 19:28:20 +00002247 for (; __first != __last; ++__first, (void) ++__p)
Howard Hinnantc51e1022010-05-11 19:42:16 +00002248 traits_type::assign(*__p, *__first);
2249 traits_type::assign(*__p, value_type());
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04002250#ifndef _LIBCPP_NO_EXCEPTIONS
2251 }
2252 catch (...)
2253 {
2254 if (__is_long())
2255 __alloc_traits::deallocate(__alloc(), __get_long_pointer(), __get_long_cap());
2256 throw;
2257 }
2258#endif // _LIBCPP_NO_EXCEPTIONS
Howard Hinnantc51e1022010-05-11 19:42:16 +00002259}
2260
2261template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierc0f566d2019-03-14 12:31:10 +00002262template<class _InputIterator, class>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002263inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00002264basic_string<_CharT, _Traits, _Allocator>::basic_string(_InputIterator __first, _InputIterator __last)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05002265 : __r_(__default_init_tag(), __default_init_tag())
Howard Hinnantc51e1022010-05-11 19:42:16 +00002266{
2267 __init(__first, __last);
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002268 std::__debug_db_insert_c(this);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002269}
2270
2271template <class _CharT, class _Traits, class _Allocator>
Eric Fiselierc0f566d2019-03-14 12:31:10 +00002272template<class _InputIterator, class>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002273inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00002274basic_string<_CharT, _Traits, _Allocator>::basic_string(_InputIterator __first, _InputIterator __last,
2275 const allocator_type& __a)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05002276 : __r_(__default_init_tag(), __a)
Howard Hinnantc51e1022010-05-11 19:42:16 +00002277{
2278 __init(__first, __last);
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002279 std::__debug_db_insert_c(this);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002280}
2281
Eric Fiselierfc92be82017-04-19 00:28:44 +00002282#ifndef _LIBCPP_CXX03_LANG
Howard Hinnant33711792011-08-12 21:56:02 +00002283
Howard Hinnantc51e1022010-05-11 19:42:16 +00002284template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002285inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Eric Fiselier812882b2017-02-17 01:17:10 +00002286basic_string<_CharT, _Traits, _Allocator>::basic_string(
2287 initializer_list<_CharT> __il)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05002288 : __r_(__default_init_tag(), __default_init_tag())
Howard Hinnantc51e1022010-05-11 19:42:16 +00002289{
2290 __init(__il.begin(), __il.end());
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002291 std::__debug_db_insert_c(this);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002292}
2293
2294template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002295inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Eric Fiselier812882b2017-02-17 01:17:10 +00002296basic_string<_CharT, _Traits, _Allocator>::basic_string(
2297 initializer_list<_CharT> __il, const _Allocator& __a)
Eric Fiselier5169d1c2019-12-16 19:03:23 -05002298 : __r_(__default_init_tag(), __a)
Howard Hinnantc51e1022010-05-11 19:42:16 +00002299{
2300 __init(__il.begin(), __il.end());
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002301 std::__debug_db_insert_c(this);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002302}
2303
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04002304#endif // _LIBCPP_CXX03_LANG
Howard Hinnant33711792011-08-12 21:56:02 +00002305
Howard Hinnantc51e1022010-05-11 19:42:16 +00002306template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002307_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00002308basic_string<_CharT, _Traits, _Allocator>::~basic_string()
2309{
Nikolas Klauser98833542022-05-07 22:20:23 +02002310 std::__debug_db_erase_c(this);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002311 if (__is_long())
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002312 __alloc_traits::deallocate(__alloc(), __get_long_pointer(), __get_long_cap());
Howard Hinnantc51e1022010-05-11 19:42:16 +00002313}
2314
2315template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002316_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00002317void
2318basic_string<_CharT, _Traits, _Allocator>::__grow_by_and_replace
2319 (size_type __old_cap, size_type __delta_cap, size_type __old_sz,
Howard Hinnantd17880b2013-06-28 16:59:19 +00002320 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 +00002321{
2322 size_type __ms = max_size();
2323 if (__delta_cap > __ms - __old_cap - 1)
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01002324 __throw_length_error();
Howard Hinnantc51e1022010-05-11 19:42:16 +00002325 pointer __old_p = __get_pointer();
2326 size_type __cap = __old_cap < __ms / 2 - __alignment ?
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002327 __recommend(std::max(__old_cap + __delta_cap, 2 * __old_cap)) :
Howard Hinnantc51e1022010-05-11 19:42:16 +00002328 __ms - 1;
Nikolas Klauserc513eba2022-04-09 09:41:19 +02002329 auto __allocation = std::__allocate_at_least(__alloc(), __cap + 1);
2330 pointer __p = __allocation.ptr;
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002331 __begin_lifetime(__p, __allocation.count);
Nikolas Klauserf1d286b2022-05-08 16:40:04 +02002332 std::__debug_db_invalidate_all(this);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002333 if (__n_copy != 0)
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002334 traits_type::copy(std::__to_address(__p),
2335 std::__to_address(__old_p), __n_copy);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002336 if (__n_add != 0)
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002337 traits_type::copy(std::__to_address(__p) + __n_copy, __p_new_stuff, __n_add);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002338 size_type __sec_cp_sz = __old_sz - __n_del - __n_copy;
2339 if (__sec_cp_sz != 0)
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002340 traits_type::copy(std::__to_address(__p) + __n_copy + __n_add,
2341 std::__to_address(__old_p) + __n_copy + __n_del, __sec_cp_sz);
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002342 if (__old_cap+1 != __min_cap || __libcpp_is_constant_evaluated())
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002343 __alloc_traits::deallocate(__alloc(), __old_p, __old_cap+1);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002344 __set_long_pointer(__p);
Nikolas Klauserc513eba2022-04-09 09:41:19 +02002345 __set_long_cap(__allocation.count);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002346 __old_sz = __n_copy + __n_add + __sec_cp_sz;
2347 __set_long_size(__old_sz);
2348 traits_type::assign(__p[__old_sz], value_type());
2349}
2350
2351template <class _CharT, class _Traits, class _Allocator>
2352void
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002353_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00002354basic_string<_CharT, _Traits, _Allocator>::__grow_by(size_type __old_cap, size_type __delta_cap, size_type __old_sz,
2355 size_type __n_copy, size_type __n_del, size_type __n_add)
2356{
2357 size_type __ms = max_size();
Marshall Clow2267c5d2013-11-06 14:24:38 +00002358 if (__delta_cap > __ms - __old_cap)
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01002359 __throw_length_error();
Howard Hinnantc51e1022010-05-11 19:42:16 +00002360 pointer __old_p = __get_pointer();
2361 size_type __cap = __old_cap < __ms / 2 - __alignment ?
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002362 __recommend(std::max(__old_cap + __delta_cap, 2 * __old_cap)) :
Howard Hinnantc51e1022010-05-11 19:42:16 +00002363 __ms - 1;
Nikolas Klauserc513eba2022-04-09 09:41:19 +02002364 auto __allocation = std::__allocate_at_least(__alloc(), __cap + 1);
2365 pointer __p = __allocation.ptr;
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002366 __begin_lifetime(__p, __allocation.count);
Nikolas Klauserf1d286b2022-05-08 16:40:04 +02002367 std::__debug_db_invalidate_all(this);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002368 if (__n_copy != 0)
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002369 traits_type::copy(std::__to_address(__p),
2370 std::__to_address(__old_p), __n_copy);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002371 size_type __sec_cp_sz = __old_sz - __n_del - __n_copy;
2372 if (__sec_cp_sz != 0)
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002373 traits_type::copy(std::__to_address(__p) + __n_copy + __n_add,
2374 std::__to_address(__old_p) + __n_copy + __n_del,
Howard Hinnantd17880b2013-06-28 16:59:19 +00002375 __sec_cp_sz);
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002376 if (__libcpp_is_constant_evaluated() || __old_cap + 1 != __min_cap)
2377 __alloc_traits::deallocate(__alloc(), __old_p, __old_cap + 1);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002378 __set_long_pointer(__p);
Nikolas Klauserc513eba2022-04-09 09:41:19 +02002379 __set_long_cap(__allocation.count);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002380}
2381
2382// assign
2383
2384template <class _CharT, class _Traits, class _Allocator>
Martijn Vels596e3de2020-02-26 15:55:49 -05002385template <bool __is_short>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002386_LIBCPP_CONSTEXPR_AFTER_CXX17
Martijn Velsb6a08b62020-04-10 18:36:31 -04002387basic_string<_CharT, _Traits, _Allocator>&
2388basic_string<_CharT, _Traits, _Allocator>::__assign_no_alias(
Martijn Vels596e3de2020-02-26 15:55:49 -05002389 const value_type* __s, size_type __n) {
Louis Dionne6209e9f2022-03-03 13:39:12 -05002390 size_type __cap = __is_short ? static_cast<size_type>(__min_cap) : __get_long_cap();
Martijn Vels596e3de2020-02-26 15:55:49 -05002391 if (__n < __cap) {
2392 pointer __p = __is_short ? __get_short_pointer() : __get_long_pointer();
2393 __is_short ? __set_short_size(__n) : __set_long_size(__n);
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002394 traits_type::copy(std::__to_address(__p), __s, __n);
Martijn Vels596e3de2020-02-26 15:55:49 -05002395 traits_type::assign(__p[__n], value_type());
2396 __invalidate_iterators_past(__n);
2397 } else {
2398 size_type __sz = __is_short ? __get_short_size() : __get_long_size();
2399 __grow_by_and_replace(__cap - 1, __n - __cap + 1, __sz, 0, __sz, __n, __s);
2400 }
Martijn Velsb6a08b62020-04-10 18:36:31 -04002401 return *this;
Martijn Vels596e3de2020-02-26 15:55:49 -05002402}
2403
2404template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002405_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00002406basic_string<_CharT, _Traits, _Allocator>&
Martijn Velsda7d94f2020-06-19 14:24:03 -04002407basic_string<_CharT, _Traits, _Allocator>::__assign_external(
2408 const value_type* __s, size_type __n) {
2409 size_type __cap = capacity();
2410 if (__cap >= __n) {
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002411 value_type* __p = std::__to_address(__get_pointer());
Martijn Velsda7d94f2020-06-19 14:24:03 -04002412 traits_type::move(__p, __s, __n);
Nikolas Klauser3ec7fb22021-12-14 01:20:53 +01002413 return __null_terminate_at(__p, __n);
Martijn Velsda7d94f2020-06-19 14:24:03 -04002414 } else {
2415 size_type __sz = size();
2416 __grow_by_and_replace(__cap, __n - __cap, __sz, 0, __sz, __n, __s);
Nikolas Klauser3ec7fb22021-12-14 01:20:53 +01002417 return *this;
Martijn Velsda7d94f2020-06-19 14:24:03 -04002418 }
Martijn Velsda7d94f2020-06-19 14:24:03 -04002419}
2420
2421template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002422_LIBCPP_CONSTEXPR_AFTER_CXX17
Martijn Velsda7d94f2020-06-19 14:24:03 -04002423basic_string<_CharT, _Traits, _Allocator>&
Howard Hinnantd17880b2013-06-28 16:59:19 +00002424basic_string<_CharT, _Traits, _Allocator>::assign(const value_type* __s, size_type __n)
Howard Hinnantc51e1022010-05-11 19:42:16 +00002425{
Alp Tokerb8a95f52014-05-15 11:27:39 +00002426 _LIBCPP_ASSERT(__n == 0 || __s != nullptr, "string::assign received nullptr");
Nikolas Klauser93826d12022-01-04 17:24:03 +01002427 return (__builtin_constant_p(__n) && __fits_in_sso(__n))
Martijn Velsda7d94f2020-06-19 14:24:03 -04002428 ? __assign_short(__s, __n)
2429 : __assign_external(__s, __n);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002430}
2431
2432template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002433_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00002434basic_string<_CharT, _Traits, _Allocator>&
2435basic_string<_CharT, _Traits, _Allocator>::assign(size_type __n, value_type __c)
2436{
2437 size_type __cap = capacity();
2438 if (__cap < __n)
2439 {
2440 size_type __sz = size();
2441 __grow_by(__cap, __n - __cap, __sz, 0, __sz);
2442 }
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002443 value_type* __p = std::__to_address(__get_pointer());
Howard Hinnantc51e1022010-05-11 19:42:16 +00002444 traits_type::assign(__p, __n, __c);
Nikolas Klauser3ec7fb22021-12-14 01:20:53 +01002445 return __null_terminate_at(__p, __n);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002446}
2447
2448template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002449_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00002450basic_string<_CharT, _Traits, _Allocator>&
2451basic_string<_CharT, _Traits, _Allocator>::operator=(value_type __c)
2452{
2453 pointer __p;
2454 if (__is_long())
2455 {
2456 __p = __get_long_pointer();
2457 __set_long_size(1);
2458 }
2459 else
2460 {
2461 __p = __get_short_pointer();
2462 __set_short_size(1);
2463 }
2464 traits_type::assign(*__p, __c);
2465 traits_type::assign(*++__p, value_type());
2466 __invalidate_iterators_past(1);
2467 return *this;
2468}
2469
2470template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002471_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002472basic_string<_CharT, _Traits, _Allocator>&
2473basic_string<_CharT, _Traits, _Allocator>::operator=(const basic_string& __str)
2474{
Martijn Vels596e3de2020-02-26 15:55:49 -05002475 if (this != &__str) {
2476 __copy_assign_alloc(__str);
2477 if (!__is_long()) {
2478 if (!__str.__is_long()) {
Eric Fiselier03bbc922020-01-15 17:27:10 -05002479 __r_.first().__r = __str.__r_.first().__r;
Martijn Vels596e3de2020-02-26 15:55:49 -05002480 } else {
Martijn Velsb6a08b62020-04-10 18:36:31 -04002481 return __assign_no_alias<true>(__str.data(), __str.size());
Martijn Vels596e3de2020-02-26 15:55:49 -05002482 }
2483 } else {
Martijn Velsb6a08b62020-04-10 18:36:31 -04002484 return __assign_no_alias<false>(__str.data(), __str.size());
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002485 }
Martijn Vels596e3de2020-02-26 15:55:49 -05002486 }
2487 return *this;
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002488}
2489
Eric Fiselierfc92be82017-04-19 00:28:44 +00002490#ifndef _LIBCPP_CXX03_LANG
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002491
2492template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002493inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002494void
2495basic_string<_CharT, _Traits, _Allocator>::__move_assign(basic_string& __str, false_type)
Marshall Clow2fe8a8d2015-08-18 18:57:00 +00002496 _NOEXCEPT_(__alloc_traits::is_always_equal::value)
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002497{
2498 if (__alloc() != __str.__alloc())
2499 assign(__str);
2500 else
2501 __move_assign(__str, true_type());
2502}
2503
2504template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002505inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002506void
2507basic_string<_CharT, _Traits, _Allocator>::__move_assign(basic_string& __str, true_type)
Marshall Clow2fe8a8d2015-08-18 18:57:00 +00002508#if _LIBCPP_STD_VER > 14
2509 _NOEXCEPT
2510#else
Howard Hinnant3e276872011-06-03 18:40:47 +00002511 _NOEXCEPT_(is_nothrow_move_assignable<allocator_type>::value)
Marshall Clow2fe8a8d2015-08-18 18:57:00 +00002512#endif
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002513{
marshall2ed41622019-11-27 07:13:00 -08002514 if (__is_long()) {
2515 __alloc_traits::deallocate(__alloc(), __get_long_pointer(),
2516 __get_long_cap());
2517#if _LIBCPP_STD_VER <= 14
2518 if (!is_nothrow_move_assignable<allocator_type>::value) {
2519 __set_short_size(0);
2520 traits_type::assign(__get_short_pointer()[0], value_type());
2521 }
2522#endif
2523 }
2524 __move_assign_alloc(__str);
2525 __r_.first() = __str.__r_.first();
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002526 if (__libcpp_is_constant_evaluated()) {
2527 __str.__default_init();
2528 } else {
2529 __str.__set_short_size(0);
2530 traits_type::assign(__str.__get_short_pointer()[0], value_type());
2531 }
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002532}
2533
2534template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002535inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002536basic_string<_CharT, _Traits, _Allocator>&
2537basic_string<_CharT, _Traits, _Allocator>::operator=(basic_string&& __str)
Marshall Clow2fe8a8d2015-08-18 18:57:00 +00002538 _NOEXCEPT_((__noexcept_move_assign_container<_Allocator, __alloc_traits>::value))
Howard Hinnantea8f7e12010-11-17 17:55:08 +00002539{
2540 __move_assign(__str, integral_constant<bool,
2541 __alloc_traits::propagate_on_container_move_assignment::value>());
2542 return *this;
2543}
2544
2545#endif
2546
2547template <class _CharT, class _Traits, class _Allocator>
Howard Hinnantc51e1022010-05-11 19:42:16 +00002548template<class _InputIterator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002549_LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04002550__enable_if_t
Howard Hinnantc51e1022010-05-11 19:42:16 +00002551<
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04002552 __is_exactly_cpp17_input_iterator<_InputIterator>::value,
Howard Hinnantc51e1022010-05-11 19:42:16 +00002553 basic_string<_CharT, _Traits, _Allocator>&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002554>
Howard Hinnantc51e1022010-05-11 19:42:16 +00002555basic_string<_CharT, _Traits, _Allocator>::assign(_InputIterator __first, _InputIterator __last)
2556{
Marshall Clow958362f2016-09-05 01:54:30 +00002557 const basic_string __temp(__first, __last, __alloc());
Marshall Clow039b2f02016-01-13 21:54:34 +00002558 assign(__temp.data(), __temp.size());
Argyrios Kyrtzidisaf904652012-10-13 02:03:45 +00002559 return *this;
Howard Hinnantc51e1022010-05-11 19:42:16 +00002560}
2561
2562template <class _CharT, class _Traits, class _Allocator>
2563template<class _ForwardIterator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002564_LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04002565__enable_if_t
Howard Hinnantc51e1022010-05-11 19:42:16 +00002566<
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04002567 __is_cpp17_forward_iterator<_ForwardIterator>::value,
Howard Hinnantc51e1022010-05-11 19:42:16 +00002568 basic_string<_CharT, _Traits, _Allocator>&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002569>
Howard Hinnantc51e1022010-05-11 19:42:16 +00002570basic_string<_CharT, _Traits, _Allocator>::assign(_ForwardIterator __first, _ForwardIterator __last)
2571{
Howard Hinnantc51e1022010-05-11 19:42:16 +00002572 size_type __cap = capacity();
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04002573 size_type __n = __string_is_trivial_iterator<_ForwardIterator>::value ?
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002574 static_cast<size_type>(std::distance(__first, __last)) : 0;
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04002575
2576 if (__string_is_trivial_iterator<_ForwardIterator>::value &&
2577 (__cap >= __n || !__addr_in_range(*__first)))
Howard Hinnantc51e1022010-05-11 19:42:16 +00002578 {
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04002579 if (__cap < __n)
2580 {
2581 size_type __sz = size();
2582 __grow_by(__cap, __n - __cap, __sz, 0, __sz);
2583 }
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04002584 pointer __p = __get_pointer();
Arthur O'Dwyer80dbcbe2021-09-07 21:35:37 -04002585 for (; __first != __last; ++__p, (void) ++__first)
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04002586 traits_type::assign(*__p, *__first);
2587 traits_type::assign(*__p, value_type());
2588 __set_size(__n);
Arthur O'Dwyerb3db4542021-04-27 09:10:04 -04002589 __invalidate_iterators_past(__n);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002590 }
2591 else
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04002592 {
2593 const basic_string __temp(__first, __last, __alloc());
2594 assign(__temp.data(), __temp.size());
2595 }
Howard Hinnantc51e1022010-05-11 19:42:16 +00002596 return *this;
2597}
2598
2599template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002600_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00002601basic_string<_CharT, _Traits, _Allocator>&
2602basic_string<_CharT, _Traits, _Allocator>::assign(const basic_string& __str, size_type __pos, size_type __n)
2603{
2604 size_type __sz = __str.size();
2605 if (__pos > __sz)
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01002606 __throw_out_of_range();
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002607 return assign(__str.data() + __pos, std::min(__n, __sz - __pos));
Howard Hinnantc51e1022010-05-11 19:42:16 +00002608}
2609
2610template <class _CharT, class _Traits, class _Allocator>
Marshall Clow82513342016-09-24 22:45:42 +00002611template <class _Tp>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002612_LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04002613__enable_if_t
Marshall Clow82513342016-09-24 22:45:42 +00002614<
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002615 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value
2616 && !__is_same_uncvref<_Tp, basic_string<_CharT, _Traits, _Allocator> >::value,
Marshall Clowb7db4972017-11-15 20:02:27 +00002617 basic_string<_CharT, _Traits, _Allocator>&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002618>
Marshall Clow82513342016-09-24 22:45:42 +00002619basic_string<_CharT, _Traits, _Allocator>::assign(const _Tp & __t, size_type __pos, size_type __n)
Marshall Clowdf63a6d2016-07-21 05:31:24 +00002620{
Marshall Clow82513342016-09-24 22:45:42 +00002621 __self_view __sv = __t;
Marshall Clowdf63a6d2016-07-21 05:31:24 +00002622 size_type __sz = __sv.size();
2623 if (__pos > __sz)
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01002624 __throw_out_of_range();
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002625 return assign(__sv.data() + __pos, std::min(__n, __sz - __pos));
Marshall Clowdf63a6d2016-07-21 05:31:24 +00002626}
2627
2628
2629template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002630_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00002631basic_string<_CharT, _Traits, _Allocator>&
Martijn Velsda7d94f2020-06-19 14:24:03 -04002632basic_string<_CharT, _Traits, _Allocator>::__assign_external(const value_type* __s) {
2633 return __assign_external(__s, traits_type::length(__s));
2634}
2635
2636template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002637_LIBCPP_CONSTEXPR_AFTER_CXX17
Martijn Velsda7d94f2020-06-19 14:24:03 -04002638basic_string<_CharT, _Traits, _Allocator>&
Howard Hinnantd17880b2013-06-28 16:59:19 +00002639basic_string<_CharT, _Traits, _Allocator>::assign(const value_type* __s)
Howard Hinnantc51e1022010-05-11 19:42:16 +00002640{
Alp Tokerb8a95f52014-05-15 11:27:39 +00002641 _LIBCPP_ASSERT(__s != nullptr, "string::assign received nullptr");
Louis Dionne3e0c4332021-08-31 10:49:06 -04002642 return __builtin_constant_p(*__s)
Nikolas Klauser93826d12022-01-04 17:24:03 +01002643 ? (__fits_in_sso(traits_type::length(__s))
Martijn Velsda7d94f2020-06-19 14:24:03 -04002644 ? __assign_short(__s, traits_type::length(__s))
2645 : __assign_external(__s, traits_type::length(__s)))
2646 : __assign_external(__s);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002647}
Howard Hinnantc51e1022010-05-11 19:42:16 +00002648// append
2649
2650template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002651_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00002652basic_string<_CharT, _Traits, _Allocator>&
Howard Hinnantd17880b2013-06-28 16:59:19 +00002653basic_string<_CharT, _Traits, _Allocator>::append(const value_type* __s, size_type __n)
Howard Hinnantc51e1022010-05-11 19:42:16 +00002654{
Alp Tokerb8a95f52014-05-15 11:27:39 +00002655 _LIBCPP_ASSERT(__n == 0 || __s != nullptr, "string::append received nullptr");
Howard Hinnantc51e1022010-05-11 19:42:16 +00002656 size_type __cap = capacity();
2657 size_type __sz = size();
2658 if (__cap - __sz >= __n)
2659 {
2660 if (__n)
2661 {
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002662 value_type* __p = std::__to_address(__get_pointer());
Howard Hinnantc51e1022010-05-11 19:42:16 +00002663 traits_type::copy(__p + __sz, __s, __n);
2664 __sz += __n;
2665 __set_size(__sz);
2666 traits_type::assign(__p[__sz], value_type());
2667 }
2668 }
2669 else
2670 __grow_by_and_replace(__cap, __sz + __n - __cap, __sz, __sz, 0, __n, __s);
2671 return *this;
2672}
2673
2674template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002675_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00002676basic_string<_CharT, _Traits, _Allocator>&
2677basic_string<_CharT, _Traits, _Allocator>::append(size_type __n, value_type __c)
2678{
2679 if (__n)
2680 {
2681 size_type __cap = capacity();
2682 size_type __sz = size();
2683 if (__cap - __sz < __n)
2684 __grow_by(__cap, __sz + __n - __cap, __sz, __sz, 0);
2685 pointer __p = __get_pointer();
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002686 traits_type::assign(std::__to_address(__p) + __sz, __n, __c);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002687 __sz += __n;
2688 __set_size(__sz);
2689 traits_type::assign(__p[__sz], value_type());
2690 }
2691 return *this;
2692}
2693
2694template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002695_LIBCPP_CONSTEXPR_AFTER_CXX17 inline void
Eric Fiselier451d5582018-11-26 20:15:38 +00002696basic_string<_CharT, _Traits, _Allocator>::__append_default_init(size_type __n)
2697{
2698 if (__n)
2699 {
2700 size_type __cap = capacity();
2701 size_type __sz = size();
2702 if (__cap - __sz < __n)
2703 __grow_by(__cap, __sz + __n - __cap, __sz, __sz, 0);
2704 pointer __p = __get_pointer();
2705 __sz += __n;
2706 __set_size(__sz);
2707 traits_type::assign(__p[__sz], value_type());
2708 }
2709}
2710
2711template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002712_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00002713void
2714basic_string<_CharT, _Traits, _Allocator>::push_back(value_type __c)
2715{
Howard Hinnant68bf1812013-04-30 21:44:48 +00002716 bool __is_short = !__is_long();
2717 size_type __cap;
2718 size_type __sz;
2719 if (__is_short)
2720 {
2721 __cap = __min_cap - 1;
2722 __sz = __get_short_size();
2723 }
2724 else
2725 {
2726 __cap = __get_long_cap() - 1;
2727 __sz = __get_long_size();
2728 }
Howard Hinnantc51e1022010-05-11 19:42:16 +00002729 if (__sz == __cap)
Howard Hinnant68bf1812013-04-30 21:44:48 +00002730 {
Howard Hinnantc51e1022010-05-11 19:42:16 +00002731 __grow_by(__cap, 1, __sz, __sz, 0);
Louis Dionne82d2b2c2021-11-16 11:26:56 -05002732 __is_short = false; // the string is always long after __grow_by
Howard Hinnant68bf1812013-04-30 21:44:48 +00002733 }
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002734 pointer __p = __get_pointer();
Howard Hinnant68bf1812013-04-30 21:44:48 +00002735 if (__is_short)
2736 {
2737 __p = __get_short_pointer() + __sz;
2738 __set_short_size(__sz+1);
2739 }
2740 else
2741 {
2742 __p = __get_long_pointer() + __sz;
2743 __set_long_size(__sz+1);
2744 }
Howard Hinnantc51e1022010-05-11 19:42:16 +00002745 traits_type::assign(*__p, __c);
2746 traits_type::assign(*++__p, value_type());
Howard Hinnantc51e1022010-05-11 19:42:16 +00002747}
2748
Howard Hinnantc51e1022010-05-11 19:42:16 +00002749template <class _CharT, class _Traits, class _Allocator>
2750template<class _ForwardIterator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002751_LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04002752__enable_if_t
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04002753<
2754 __is_cpp17_forward_iterator<_ForwardIterator>::value,
2755 basic_string<_CharT, _Traits, _Allocator>&
2756>
2757basic_string<_CharT, _Traits, _Allocator>::append(
Eric Fiselierdb7ee8f2016-10-31 02:46:25 +00002758 _ForwardIterator __first, _ForwardIterator __last)
Howard Hinnantc51e1022010-05-11 19:42:16 +00002759{
2760 size_type __sz = size();
2761 size_type __cap = capacity();
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002762 size_type __n = static_cast<size_type>(std::distance(__first, __last));
Howard Hinnantc51e1022010-05-11 19:42:16 +00002763 if (__n)
2764 {
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04002765 if (__string_is_trivial_iterator<_ForwardIterator>::value &&
2766 !__addr_in_range(*__first))
Marshall Clow958362f2016-09-05 01:54:30 +00002767 {
2768 if (__cap - __sz < __n)
2769 __grow_by(__cap, __sz + __n - __cap, __sz, __sz, 0);
2770 pointer __p = __get_pointer() + __sz;
Arthur O'Dwyer80dbcbe2021-09-07 21:35:37 -04002771 for (; __first != __last; ++__p, (void) ++__first)
Marshall Clow958362f2016-09-05 01:54:30 +00002772 traits_type::assign(*__p, *__first);
2773 traits_type::assign(*__p, value_type());
2774 __set_size(__sz + __n);
2775 }
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04002776 else
2777 {
2778 const basic_string __temp(__first, __last, __alloc());
2779 append(__temp.data(), __temp.size());
2780 }
Howard Hinnantc51e1022010-05-11 19:42:16 +00002781 }
2782 return *this;
2783}
2784
2785template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002786inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00002787basic_string<_CharT, _Traits, _Allocator>&
2788basic_string<_CharT, _Traits, _Allocator>::append(const basic_string& __str)
2789{
2790 return append(__str.data(), __str.size());
2791}
2792
2793template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002794_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00002795basic_string<_CharT, _Traits, _Allocator>&
2796basic_string<_CharT, _Traits, _Allocator>::append(const basic_string& __str, size_type __pos, size_type __n)
2797{
2798 size_type __sz = __str.size();
2799 if (__pos > __sz)
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01002800 __throw_out_of_range();
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002801 return append(__str.data() + __pos, std::min(__n, __sz - __pos));
Howard Hinnantc51e1022010-05-11 19:42:16 +00002802}
2803
2804template <class _CharT, class _Traits, class _Allocator>
Marshall Clow62953962016-10-03 23:40:48 +00002805template <class _Tp>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002806_LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04002807 __enable_if_t
Marshall Clow82513342016-09-24 22:45:42 +00002808 <
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002809 __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 +00002810 basic_string<_CharT, _Traits, _Allocator>&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002811 >
Marshall Clow82513342016-09-24 22:45:42 +00002812basic_string<_CharT, _Traits, _Allocator>::append(const _Tp & __t, size_type __pos, size_type __n)
Marshall Clowdf63a6d2016-07-21 05:31:24 +00002813{
Marshall Clow82513342016-09-24 22:45:42 +00002814 __self_view __sv = __t;
Marshall Clowdf63a6d2016-07-21 05:31:24 +00002815 size_type __sz = __sv.size();
2816 if (__pos > __sz)
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01002817 __throw_out_of_range();
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002818 return append(__sv.data() + __pos, std::min(__n, __sz - __pos));
Marshall Clowdf63a6d2016-07-21 05:31:24 +00002819}
2820
2821template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002822_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00002823basic_string<_CharT, _Traits, _Allocator>&
Howard Hinnantd17880b2013-06-28 16:59:19 +00002824basic_string<_CharT, _Traits, _Allocator>::append(const value_type* __s)
Howard Hinnantc51e1022010-05-11 19:42:16 +00002825{
Alp Tokerb8a95f52014-05-15 11:27:39 +00002826 _LIBCPP_ASSERT(__s != nullptr, "string::append received nullptr");
Howard Hinnantc51e1022010-05-11 19:42:16 +00002827 return append(__s, traits_type::length(__s));
2828}
2829
2830// insert
2831
2832template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002833_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00002834basic_string<_CharT, _Traits, _Allocator>&
Howard Hinnantd17880b2013-06-28 16:59:19 +00002835basic_string<_CharT, _Traits, _Allocator>::insert(size_type __pos, const value_type* __s, size_type __n)
Howard Hinnantc51e1022010-05-11 19:42:16 +00002836{
Alp Tokerb8a95f52014-05-15 11:27:39 +00002837 _LIBCPP_ASSERT(__n == 0 || __s != nullptr, "string::insert received nullptr");
Howard Hinnantc51e1022010-05-11 19:42:16 +00002838 size_type __sz = size();
2839 if (__pos > __sz)
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01002840 __throw_out_of_range();
Howard Hinnantc51e1022010-05-11 19:42:16 +00002841 size_type __cap = capacity();
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002842 if (__libcpp_is_constant_evaluated()) {
2843 if (__cap - __sz >= __n)
2844 __grow_by_and_replace(__cap, 0, __sz, __pos, 0, __n, __s);
2845 else
2846 __grow_by_and_replace(__cap, __sz + __n - __cap, __sz, __pos, 0, __n, __s);
2847 return *this;
2848 }
Howard Hinnantc51e1022010-05-11 19:42:16 +00002849 if (__cap - __sz >= __n)
2850 {
2851 if (__n)
2852 {
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002853 value_type* __p = std::__to_address(__get_pointer());
Howard Hinnantc51e1022010-05-11 19:42:16 +00002854 size_type __n_move = __sz - __pos;
2855 if (__n_move != 0)
2856 {
2857 if (__p + __pos <= __s && __s < __p + __sz)
2858 __s += __n;
2859 traits_type::move(__p + __pos + __n, __p + __pos, __n_move);
2860 }
2861 traits_type::move(__p + __pos, __s, __n);
2862 __sz += __n;
2863 __set_size(__sz);
2864 traits_type::assign(__p[__sz], value_type());
2865 }
2866 }
2867 else
2868 __grow_by_and_replace(__cap, __sz + __n - __cap, __sz, __pos, 0, __n, __s);
2869 return *this;
2870}
2871
2872template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002873_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00002874basic_string<_CharT, _Traits, _Allocator>&
2875basic_string<_CharT, _Traits, _Allocator>::insert(size_type __pos, size_type __n, value_type __c)
2876{
2877 size_type __sz = size();
2878 if (__pos > __sz)
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01002879 __throw_out_of_range();
Howard Hinnantc51e1022010-05-11 19:42:16 +00002880 if (__n)
2881 {
2882 size_type __cap = capacity();
Howard Hinnantd17880b2013-06-28 16:59:19 +00002883 value_type* __p;
Howard Hinnantc51e1022010-05-11 19:42:16 +00002884 if (__cap - __sz >= __n)
2885 {
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002886 __p = std::__to_address(__get_pointer());
Howard Hinnantc51e1022010-05-11 19:42:16 +00002887 size_type __n_move = __sz - __pos;
2888 if (__n_move != 0)
2889 traits_type::move(__p + __pos + __n, __p + __pos, __n_move);
2890 }
2891 else
2892 {
2893 __grow_by(__cap, __sz + __n - __cap, __sz, __pos, 0, __n);
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002894 __p = std::__to_address(__get_long_pointer());
Howard Hinnantc51e1022010-05-11 19:42:16 +00002895 }
2896 traits_type::assign(__p + __pos, __n, __c);
2897 __sz += __n;
2898 __set_size(__sz);
2899 traits_type::assign(__p[__sz], value_type());
2900 }
2901 return *this;
2902}
2903
2904template <class _CharT, class _Traits, class _Allocator>
2905template<class _InputIterator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002906_LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04002907__enable_if_t
Howard Hinnantc51e1022010-05-11 19:42:16 +00002908<
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04002909 __is_exactly_cpp17_input_iterator<_InputIterator>::value,
Marshall Clow039b2f02016-01-13 21:54:34 +00002910 typename basic_string<_CharT, _Traits, _Allocator>::iterator
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002911>
Howard Hinnantc51e1022010-05-11 19:42:16 +00002912basic_string<_CharT, _Traits, _Allocator>::insert(const_iterator __pos, _InputIterator __first, _InputIterator __last)
2913{
Nikolas Klausereed25832021-12-15 01:32:30 +01002914 _LIBCPP_DEBUG_ASSERT(__get_const_db()->__find_c_from_i(&__pos) == this,
2915 "string::insert(iterator, range) called with an iterator not"
2916 " referring to this string");
2917 const basic_string __temp(__first, __last, __alloc());
2918 return insert(__pos, __temp.data(), __temp.data() + __temp.size());
Howard Hinnantc51e1022010-05-11 19:42:16 +00002919}
2920
2921template <class _CharT, class _Traits, class _Allocator>
2922template<class _ForwardIterator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002923_LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04002924__enable_if_t
Howard Hinnantc51e1022010-05-11 19:42:16 +00002925<
Arthur O'Dwyer98ff31f2021-04-16 17:49:57 -04002926 __is_cpp17_forward_iterator<_ForwardIterator>::value,
Howard Hinnantc51e1022010-05-11 19:42:16 +00002927 typename basic_string<_CharT, _Traits, _Allocator>::iterator
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002928>
Howard Hinnantc51e1022010-05-11 19:42:16 +00002929basic_string<_CharT, _Traits, _Allocator>::insert(const_iterator __pos, _ForwardIterator __first, _ForwardIterator __last)
2930{
Nikolas Klauser48d680d2022-02-26 13:28:33 +01002931 _LIBCPP_DEBUG_ASSERT(__get_const_db()->__find_c_from_i(&__pos) == this,
2932 "string::insert(iterator, range) called with an iterator not referring to this string");
Nikolas Klausereed25832021-12-15 01:32:30 +01002933
Howard Hinnantc51e1022010-05-11 19:42:16 +00002934 size_type __ip = static_cast<size_type>(__pos - begin());
Nikolas Klauser48d680d2022-02-26 13:28:33 +01002935 size_type __n = static_cast<size_type>(std::distance(__first, __last));
2936 if (__n == 0)
2937 return begin() + __ip;
2938
2939 if (__string_is_trivial_iterator<_ForwardIterator>::value && !__addr_in_range(*__first))
Howard Hinnantc51e1022010-05-11 19:42:16 +00002940 {
Nikolas Klauser48d680d2022-02-26 13:28:33 +01002941 return __insert_from_safe_copy(__n, __ip, __first, __last);
Howard Hinnantc51e1022010-05-11 19:42:16 +00002942 }
Nikolas Klauser48d680d2022-02-26 13:28:33 +01002943 else
2944 {
2945 const basic_string __temp(__first, __last, __alloc());
2946 return __insert_from_safe_copy(__n, __ip, __temp.begin(), __temp.end());
2947 }
Howard Hinnantc51e1022010-05-11 19:42:16 +00002948}
2949
2950template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002951inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00002952basic_string<_CharT, _Traits, _Allocator>&
2953basic_string<_CharT, _Traits, _Allocator>::insert(size_type __pos1, const basic_string& __str)
2954{
2955 return insert(__pos1, __str.data(), __str.size());
2956}
2957
2958template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002959_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00002960basic_string<_CharT, _Traits, _Allocator>&
2961basic_string<_CharT, _Traits, _Allocator>::insert(size_type __pos1, const basic_string& __str,
2962 size_type __pos2, size_type __n)
2963{
2964 size_type __str_sz = __str.size();
2965 if (__pos2 > __str_sz)
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01002966 __throw_out_of_range();
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002967 return insert(__pos1, __str.data() + __pos2, std::min(__n, __str_sz - __pos2));
Howard Hinnantc51e1022010-05-11 19:42:16 +00002968}
2969
2970template <class _CharT, class _Traits, class _Allocator>
Marshall Clow82513342016-09-24 22:45:42 +00002971template <class _Tp>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002972_LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04002973__enable_if_t
Marshall Clow82513342016-09-24 22:45:42 +00002974<
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002975 __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 +00002976 basic_string<_CharT, _Traits, _Allocator>&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05002977>
Marshall Clow82513342016-09-24 22:45:42 +00002978basic_string<_CharT, _Traits, _Allocator>::insert(size_type __pos1, const _Tp& __t,
Marshall Clowdf63a6d2016-07-21 05:31:24 +00002979 size_type __pos2, size_type __n)
2980{
Marshall Clow82513342016-09-24 22:45:42 +00002981 __self_view __sv = __t;
Marshall Clowdf63a6d2016-07-21 05:31:24 +00002982 size_type __str_sz = __sv.size();
2983 if (__pos2 > __str_sz)
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01002984 __throw_out_of_range();
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02002985 return insert(__pos1, __sv.data() + __pos2, std::min(__n, __str_sz - __pos2));
Marshall Clowdf63a6d2016-07-21 05:31:24 +00002986}
2987
2988template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002989_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00002990basic_string<_CharT, _Traits, _Allocator>&
Howard Hinnantd17880b2013-06-28 16:59:19 +00002991basic_string<_CharT, _Traits, _Allocator>::insert(size_type __pos, const value_type* __s)
Howard Hinnantc51e1022010-05-11 19:42:16 +00002992{
Alp Tokerb8a95f52014-05-15 11:27:39 +00002993 _LIBCPP_ASSERT(__s != nullptr, "string::insert received nullptr");
Howard Hinnantc51e1022010-05-11 19:42:16 +00002994 return insert(__pos, __s, traits_type::length(__s));
2995}
2996
2997template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02002998_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00002999typename basic_string<_CharT, _Traits, _Allocator>::iterator
3000basic_string<_CharT, _Traits, _Allocator>::insert(const_iterator __pos, value_type __c)
3001{
Louis Dionnef4cc6fb2022-02-15 15:47:45 -05003002 _LIBCPP_DEBUG_ASSERT(__get_const_db()->__find_c_from_i(&__pos) == this,
3003 "string::insert(iterator, character) called with an iterator not"
3004 " referring to this string");
3005
Howard Hinnantc51e1022010-05-11 19:42:16 +00003006 size_type __ip = static_cast<size_type>(__pos - begin());
3007 size_type __sz = size();
3008 size_type __cap = capacity();
Howard Hinnantd17880b2013-06-28 16:59:19 +00003009 value_type* __p;
Howard Hinnantc51e1022010-05-11 19:42:16 +00003010 if (__cap == __sz)
3011 {
3012 __grow_by(__cap, 1, __sz, __ip, 0, 1);
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02003013 __p = std::__to_address(__get_long_pointer());
Howard Hinnantc51e1022010-05-11 19:42:16 +00003014 }
3015 else
3016 {
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02003017 __p = std::__to_address(__get_pointer());
Howard Hinnantc51e1022010-05-11 19:42:16 +00003018 size_type __n_move = __sz - __ip;
3019 if (__n_move != 0)
3020 traits_type::move(__p + __ip + 1, __p + __ip, __n_move);
3021 }
3022 traits_type::assign(__p[__ip], __c);
3023 traits_type::assign(__p[++__sz], value_type());
3024 __set_size(__sz);
3025 return begin() + static_cast<difference_type>(__ip);
3026}
3027
3028template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003029inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003030typename basic_string<_CharT, _Traits, _Allocator>::iterator
3031basic_string<_CharT, _Traits, _Allocator>::insert(const_iterator __pos, size_type __n, value_type __c)
3032{
Nikolas Klausereed25832021-12-15 01:32:30 +01003033 _LIBCPP_DEBUG_ASSERT(__get_const_db()->__find_c_from_i(&__pos) == this,
3034 "string::insert(iterator, n, value) called with an iterator not"
3035 " referring to this string");
3036 difference_type __p = __pos - begin();
3037 insert(static_cast<size_type>(__p), __n, __c);
3038 return begin() + __p;
Howard Hinnantc51e1022010-05-11 19:42:16 +00003039}
3040
3041// replace
3042
3043template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003044_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003045basic_string<_CharT, _Traits, _Allocator>&
Howard Hinnantd17880b2013-06-28 16:59:19 +00003046basic_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 +00003047 _LIBCPP_DISABLE_UBSAN_UNSIGNED_INTEGER_CHECK
Howard Hinnantc51e1022010-05-11 19:42:16 +00003048{
Alp Tokerb8a95f52014-05-15 11:27:39 +00003049 _LIBCPP_ASSERT(__n2 == 0 || __s != nullptr, "string::replace received nullptr");
Howard Hinnantc51e1022010-05-11 19:42:16 +00003050 size_type __sz = size();
3051 if (__pos > __sz)
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01003052 __throw_out_of_range();
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02003053 __n1 = std::min(__n1, __sz - __pos);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003054 size_type __cap = capacity();
3055 if (__cap - __sz + __n1 >= __n2)
3056 {
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003057 if (__libcpp_is_constant_evaluated()) {
3058 __grow_by_and_replace(__cap, 0, __sz, __pos, __n1, __n2, __s);
3059 return *this;
3060 }
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02003061 value_type* __p = std::__to_address(__get_pointer());
Howard Hinnantc51e1022010-05-11 19:42:16 +00003062 if (__n1 != __n2)
3063 {
3064 size_type __n_move = __sz - __pos - __n1;
3065 if (__n_move != 0)
3066 {
3067 if (__n1 > __n2)
3068 {
3069 traits_type::move(__p + __pos, __s, __n2);
3070 traits_type::move(__p + __pos + __n2, __p + __pos + __n1, __n_move);
Nikolas Klauser3ec7fb22021-12-14 01:20:53 +01003071 return __null_terminate_at(__p, __sz + (__n2 - __n1));
Howard Hinnantc51e1022010-05-11 19:42:16 +00003072 }
3073 if (__p + __pos < __s && __s < __p + __sz)
3074 {
3075 if (__p + __pos + __n1 <= __s)
3076 __s += __n2 - __n1;
3077 else // __p + __pos < __s < __p + __pos + __n1
3078 {
3079 traits_type::move(__p + __pos, __s, __n1);
3080 __pos += __n1;
3081 __s += __n2;
3082 __n2 -= __n1;
3083 __n1 = 0;
3084 }
3085 }
3086 traits_type::move(__p + __pos + __n2, __p + __pos + __n1, __n_move);
3087 }
3088 }
3089 traits_type::move(__p + __pos, __s, __n2);
Nikolas Klauser3ec7fb22021-12-14 01:20:53 +01003090 return __null_terminate_at(__p, __sz + (__n2 - __n1));
Howard Hinnantc51e1022010-05-11 19:42:16 +00003091 }
3092 else
3093 __grow_by_and_replace(__cap, __sz - __n1 + __n2 - __cap, __sz, __pos, __n1, __n2, __s);
3094 return *this;
3095}
3096
3097template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003098_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003099basic_string<_CharT, _Traits, _Allocator>&
3100basic_string<_CharT, _Traits, _Allocator>::replace(size_type __pos, size_type __n1, size_type __n2, value_type __c)
3101{
3102 size_type __sz = size();
3103 if (__pos > __sz)
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01003104 __throw_out_of_range();
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02003105 __n1 = std::min(__n1, __sz - __pos);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003106 size_type __cap = capacity();
Howard Hinnantd17880b2013-06-28 16:59:19 +00003107 value_type* __p;
Howard Hinnantc51e1022010-05-11 19:42:16 +00003108 if (__cap - __sz + __n1 >= __n2)
3109 {
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02003110 __p = std::__to_address(__get_pointer());
Howard Hinnantc51e1022010-05-11 19:42:16 +00003111 if (__n1 != __n2)
3112 {
3113 size_type __n_move = __sz - __pos - __n1;
3114 if (__n_move != 0)
3115 traits_type::move(__p + __pos + __n2, __p + __pos + __n1, __n_move);
3116 }
3117 }
3118 else
3119 {
3120 __grow_by(__cap, __sz - __n1 + __n2 - __cap, __sz, __pos, __n1, __n2);
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02003121 __p = std::__to_address(__get_long_pointer());
Howard Hinnantc51e1022010-05-11 19:42:16 +00003122 }
3123 traits_type::assign(__p + __pos, __n2, __c);
Nikolas Klauser3ec7fb22021-12-14 01:20:53 +01003124 return __null_terminate_at(__p, __sz - (__n1 - __n2));
Howard Hinnantc51e1022010-05-11 19:42:16 +00003125}
3126
3127template <class _CharT, class _Traits, class _Allocator>
3128template<class _InputIterator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003129_LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04003130__enable_if_t
Howard Hinnantc51e1022010-05-11 19:42:16 +00003131<
Eric Fiseliercd5a6772019-11-18 01:46:58 -05003132 __is_cpp17_input_iterator<_InputIterator>::value,
Howard Hinnantc51e1022010-05-11 19:42:16 +00003133 basic_string<_CharT, _Traits, _Allocator>&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003134>
Howard Hinnant990d6e82010-11-17 21:11:40 +00003135basic_string<_CharT, _Traits, _Allocator>::replace(const_iterator __i1, const_iterator __i2,
Howard Hinnantc51e1022010-05-11 19:42:16 +00003136 _InputIterator __j1, _InputIterator __j2)
3137{
Marshall Clow958362f2016-09-05 01:54:30 +00003138 const basic_string __temp(__j1, __j2, __alloc());
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01003139 return replace(__i1, __i2, __temp);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003140}
3141
3142template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003143inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003144basic_string<_CharT, _Traits, _Allocator>&
3145basic_string<_CharT, _Traits, _Allocator>::replace(size_type __pos1, size_type __n1, const basic_string& __str)
3146{
3147 return replace(__pos1, __n1, __str.data(), __str.size());
3148}
3149
3150template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003151_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003152basic_string<_CharT, _Traits, _Allocator>&
3153basic_string<_CharT, _Traits, _Allocator>::replace(size_type __pos1, size_type __n1, const basic_string& __str,
3154 size_type __pos2, size_type __n2)
3155{
3156 size_type __str_sz = __str.size();
3157 if (__pos2 > __str_sz)
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01003158 __throw_out_of_range();
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02003159 return replace(__pos1, __n1, __str.data() + __pos2, std::min(__n2, __str_sz - __pos2));
Howard Hinnantc51e1022010-05-11 19:42:16 +00003160}
3161
3162template <class _CharT, class _Traits, class _Allocator>
Marshall Clow82513342016-09-24 22:45:42 +00003163template <class _Tp>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003164_LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04003165__enable_if_t
Marshall Clow82513342016-09-24 22:45:42 +00003166<
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003167 __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 +00003168 basic_string<_CharT, _Traits, _Allocator>&
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003169>
Marshall Clow82513342016-09-24 22:45:42 +00003170basic_string<_CharT, _Traits, _Allocator>::replace(size_type __pos1, size_type __n1, const _Tp& __t,
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003171 size_type __pos2, size_type __n2)
3172{
Marshall Clow82513342016-09-24 22:45:42 +00003173 __self_view __sv = __t;
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003174 size_type __str_sz = __sv.size();
3175 if (__pos2 > __str_sz)
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01003176 __throw_out_of_range();
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02003177 return replace(__pos1, __n1, __sv.data() + __pos2, std::min(__n2, __str_sz - __pos2));
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003178}
3179
3180template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003181_LIBCPP_CONSTEXPR_AFTER_CXX17
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003182basic_string<_CharT, _Traits, _Allocator>&
Howard Hinnantd17880b2013-06-28 16:59:19 +00003183basic_string<_CharT, _Traits, _Allocator>::replace(size_type __pos, size_type __n1, const value_type* __s)
Howard Hinnantc51e1022010-05-11 19:42:16 +00003184{
Alp Tokerb8a95f52014-05-15 11:27:39 +00003185 _LIBCPP_ASSERT(__s != nullptr, "string::replace received nullptr");
Howard Hinnantc51e1022010-05-11 19:42:16 +00003186 return replace(__pos, __n1, __s, traits_type::length(__s));
3187}
3188
3189template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003190inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003191basic_string<_CharT, _Traits, _Allocator>&
Howard Hinnant990d6e82010-11-17 21:11:40 +00003192basic_string<_CharT, _Traits, _Allocator>::replace(const_iterator __i1, const_iterator __i2, const basic_string& __str)
Howard Hinnantc51e1022010-05-11 19:42:16 +00003193{
3194 return replace(static_cast<size_type>(__i1 - begin()), static_cast<size_type>(__i2 - __i1),
3195 __str.data(), __str.size());
3196}
3197
3198template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003199inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003200basic_string<_CharT, _Traits, _Allocator>&
Howard Hinnantd17880b2013-06-28 16:59:19 +00003201basic_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 +00003202{
3203 return replace(static_cast<size_type>(__i1 - begin()), static_cast<size_type>(__i2 - __i1), __s, __n);
3204}
3205
3206template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003207inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003208basic_string<_CharT, _Traits, _Allocator>&
Howard Hinnantd17880b2013-06-28 16:59:19 +00003209basic_string<_CharT, _Traits, _Allocator>::replace(const_iterator __i1, const_iterator __i2, const value_type* __s)
Howard Hinnantc51e1022010-05-11 19:42:16 +00003210{
3211 return replace(static_cast<size_type>(__i1 - begin()), static_cast<size_type>(__i2 - __i1), __s);
3212}
3213
3214template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003215inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003216basic_string<_CharT, _Traits, _Allocator>&
Howard Hinnant990d6e82010-11-17 21:11:40 +00003217basic_string<_CharT, _Traits, _Allocator>::replace(const_iterator __i1, const_iterator __i2, size_type __n, value_type __c)
Howard Hinnantc51e1022010-05-11 19:42:16 +00003218{
3219 return replace(static_cast<size_type>(__i1 - begin()), static_cast<size_type>(__i2 - __i1), __n, __c);
3220}
3221
3222// erase
3223
Martijn Velsa81fc792020-02-26 13:25:43 -05003224// 'externally instantiated' erase() implementation, called when __n != npos.
3225// Does not check __pos against size()
Howard Hinnantc51e1022010-05-11 19:42:16 +00003226template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003227_LIBCPP_CONSTEXPR_AFTER_CXX17
Martijn Velsa81fc792020-02-26 13:25:43 -05003228void
3229basic_string<_CharT, _Traits, _Allocator>::__erase_external_with_move(
3230 size_type __pos, size_type __n)
Howard Hinnantc51e1022010-05-11 19:42:16 +00003231{
Howard Hinnantc51e1022010-05-11 19:42:16 +00003232 if (__n)
3233 {
Martijn Velsa81fc792020-02-26 13:25:43 -05003234 size_type __sz = size();
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02003235 value_type* __p = std::__to_address(__get_pointer());
3236 __n = std::min(__n, __sz - __pos);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003237 size_type __n_move = __sz - __pos - __n;
3238 if (__n_move != 0)
3239 traits_type::move(__p + __pos, __p + __pos + __n, __n_move);
Nikolas Klauser3ec7fb22021-12-14 01:20:53 +01003240 __null_terminate_at(__p, __sz - __n);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003241 }
Martijn Velsa81fc792020-02-26 13:25:43 -05003242}
3243
3244template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003245_LIBCPP_CONSTEXPR_AFTER_CXX17
Martijn Velsa81fc792020-02-26 13:25:43 -05003246basic_string<_CharT, _Traits, _Allocator>&
3247basic_string<_CharT, _Traits, _Allocator>::erase(size_type __pos,
3248 size_type __n) {
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01003249 if (__pos > size())
3250 __throw_out_of_range();
Martijn Velsa81fc792020-02-26 13:25:43 -05003251 if (__n == npos) {
3252 __erase_to_end(__pos);
3253 } else {
3254 __erase_external_with_move(__pos, __n);
3255 }
3256 return *this;
Howard Hinnantc51e1022010-05-11 19:42:16 +00003257}
3258
3259template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003260inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003261typename basic_string<_CharT, _Traits, _Allocator>::iterator
3262basic_string<_CharT, _Traits, _Allocator>::erase(const_iterator __pos)
3263{
Nikolas Klausereed25832021-12-15 01:32:30 +01003264 _LIBCPP_DEBUG_ASSERT(__get_const_db()->__find_c_from_i(&__pos) == this,
3265 "string::erase(iterator) called with an iterator not"
3266 " referring to this string");
3267
3268 _LIBCPP_ASSERT(__pos != end(), "string::erase(iterator) called with a non-dereferenceable iterator");
3269 iterator __b = begin();
3270 size_type __r = static_cast<size_type>(__pos - __b);
3271 erase(__r, 1);
3272 return __b + static_cast<difference_type>(__r);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003273}
3274
3275template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003276inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003277typename basic_string<_CharT, _Traits, _Allocator>::iterator
3278basic_string<_CharT, _Traits, _Allocator>::erase(const_iterator __first, const_iterator __last)
3279{
Nikolas Klausereed25832021-12-15 01:32:30 +01003280 _LIBCPP_DEBUG_ASSERT(__get_const_db()->__find_c_from_i(&__first) == this,
3281 "string::erase(iterator, iterator) called with an iterator not"
3282 " referring to this string");
3283
3284 _LIBCPP_ASSERT(__first <= __last, "string::erase(first, last) called with invalid range");
3285 iterator __b = begin();
3286 size_type __r = static_cast<size_type>(__first - __b);
3287 erase(__r, static_cast<size_type>(__last - __first));
3288 return __b + static_cast<difference_type>(__r);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003289}
3290
3291template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003292inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003293void
3294basic_string<_CharT, _Traits, _Allocator>::pop_back()
3295{
Howard Hinnant8ea98242013-08-23 17:37:05 +00003296 _LIBCPP_ASSERT(!empty(), "string::pop_back(): string is already empty");
Nikolas Klauser3ec7fb22021-12-14 01:20:53 +01003297 __erase_to_end(size() - 1);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003298}
3299
3300template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003301inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003302void
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003303basic_string<_CharT, _Traits, _Allocator>::clear() _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003304{
Nikolas Klauserf1d286b2022-05-08 16:40:04 +02003305 std::__debug_db_invalidate_all(this);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003306 if (__is_long())
3307 {
3308 traits_type::assign(*__get_long_pointer(), value_type());
3309 __set_long_size(0);
3310 }
3311 else
3312 {
3313 traits_type::assign(*__get_short_pointer(), value_type());
3314 __set_short_size(0);
3315 }
3316}
3317
3318template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003319inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003320void
3321basic_string<_CharT, _Traits, _Allocator>::__erase_to_end(size_type __pos)
3322{
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02003323 __null_terminate_at(std::__to_address(__get_pointer()), __pos);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003324}
3325
3326template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003327_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003328void
3329basic_string<_CharT, _Traits, _Allocator>::resize(size_type __n, value_type __c)
3330{
3331 size_type __sz = size();
3332 if (__n > __sz)
3333 append(__n - __sz, __c);
3334 else
3335 __erase_to_end(__n);
3336}
3337
3338template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003339_LIBCPP_CONSTEXPR_AFTER_CXX17 inline void
Eric Fiselier451d5582018-11-26 20:15:38 +00003340basic_string<_CharT, _Traits, _Allocator>::__resize_default_init(size_type __n)
3341{
3342 size_type __sz = size();
3343 if (__n > __sz) {
3344 __append_default_init(__n - __sz);
3345 } else
3346 __erase_to_end(__n);
3347}
3348
3349template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003350inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003351typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003352basic_string<_CharT, _Traits, _Allocator>::max_size() const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003353{
Howard Hinnantea8f7e12010-11-17 17:55:08 +00003354 size_type __m = __alloc_traits::max_size(__alloc());
Nikolas Klauser62060be2022-04-20 10:52:04 +02003355 if (__m <= std::numeric_limits<size_type>::max() / 2) {
3356 return __m - __alignment;
3357 } else {
3358 bool __uses_lsb = __endian_factor == 2;
3359 return __uses_lsb ? __m - __alignment : (__m / 2) - __alignment;
3360 }
Howard Hinnantc51e1022010-05-11 19:42:16 +00003361}
3362
3363template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003364_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003365void
Marek Kurdejc9848142020-11-26 10:07:16 +01003366basic_string<_CharT, _Traits, _Allocator>::reserve(size_type __requested_capacity)
Howard Hinnantc51e1022010-05-11 19:42:16 +00003367{
Marek Kurdejc9848142020-11-26 10:07:16 +01003368 if (__requested_capacity > max_size())
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01003369 __throw_length_error();
Marek Kurdejc9848142020-11-26 10:07:16 +01003370
Louis Dionne05b6d3e2022-01-14 12:30:22 -05003371 // Make sure reserve(n) never shrinks. This is technically only required in C++20
3372 // and later (since P0966R1), however we provide consistent behavior in all Standard
3373 // modes because this function is instantiated in the shared library.
3374 if (__requested_capacity <= capacity())
3375 return;
Marek Kurdejc9848142020-11-26 10:07:16 +01003376
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02003377 size_type __target_capacity = std::max(__requested_capacity, size());
Marek Kurdejc9848142020-11-26 10:07:16 +01003378 __target_capacity = __recommend(__target_capacity);
3379 if (__target_capacity == capacity()) return;
3380
3381 __shrink_or_extend(__target_capacity);
3382}
3383
3384template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003385inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Marek Kurdejc9848142020-11-26 10:07:16 +01003386void
3387basic_string<_CharT, _Traits, _Allocator>::shrink_to_fit() _NOEXCEPT
3388{
3389 size_type __target_capacity = __recommend(size());
3390 if (__target_capacity == capacity()) return;
3391
3392 __shrink_or_extend(__target_capacity);
3393}
3394
3395template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003396inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Marek Kurdejc9848142020-11-26 10:07:16 +01003397void
3398basic_string<_CharT, _Traits, _Allocator>::__shrink_or_extend(size_type __target_capacity)
3399{
Howard Hinnantc51e1022010-05-11 19:42:16 +00003400 size_type __cap = capacity();
3401 size_type __sz = size();
Marek Kurdejc9848142020-11-26 10:07:16 +01003402
3403 pointer __new_data, __p;
3404 bool __was_long, __now_long;
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003405 if (__fits_in_sso(__target_capacity))
Howard Hinnantc51e1022010-05-11 19:42:16 +00003406 {
Marek Kurdejc9848142020-11-26 10:07:16 +01003407 __was_long = true;
3408 __now_long = false;
3409 __new_data = __get_short_pointer();
3410 __p = __get_long_pointer();
Howard Hinnantc51e1022010-05-11 19:42:16 +00003411 }
Marek Kurdejc9848142020-11-26 10:07:16 +01003412 else
3413 {
Nikolas Klauserc513eba2022-04-09 09:41:19 +02003414 if (__target_capacity > __cap) {
3415 auto __allocation = std::__allocate_at_least(__alloc(), __target_capacity + 1);
3416 __new_data = __allocation.ptr;
3417 __target_capacity = __allocation.count - 1;
3418 }
Marek Kurdejc9848142020-11-26 10:07:16 +01003419 else
3420 {
3421 #ifndef _LIBCPP_NO_EXCEPTIONS
3422 try
3423 {
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04003424 #endif // _LIBCPP_NO_EXCEPTIONS
Nikolas Klauserc513eba2022-04-09 09:41:19 +02003425 auto __allocation = std::__allocate_at_least(__alloc(), __target_capacity + 1);
3426 __new_data = __allocation.ptr;
3427 __target_capacity = __allocation.count - 1;
Marek Kurdejc9848142020-11-26 10:07:16 +01003428 #ifndef _LIBCPP_NO_EXCEPTIONS
3429 }
3430 catch (...)
3431 {
3432 return;
3433 }
3434 #else // _LIBCPP_NO_EXCEPTIONS
3435 if (__new_data == nullptr)
3436 return;
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04003437 #endif // _LIBCPP_NO_EXCEPTIONS
Marek Kurdejc9848142020-11-26 10:07:16 +01003438 }
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003439 __begin_lifetime(__new_data, __target_capacity + 1);
Marek Kurdejc9848142020-11-26 10:07:16 +01003440 __now_long = true;
3441 __was_long = __is_long();
3442 __p = __get_pointer();
3443 }
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02003444 traits_type::copy(std::__to_address(__new_data),
3445 std::__to_address(__p), size()+1);
Marek Kurdejc9848142020-11-26 10:07:16 +01003446 if (__was_long)
3447 __alloc_traits::deallocate(__alloc(), __p, __cap+1);
3448 if (__now_long)
3449 {
3450 __set_long_cap(__target_capacity+1);
3451 __set_long_size(__sz);
3452 __set_long_pointer(__new_data);
3453 }
3454 else
3455 __set_short_size(__sz);
Nikolas Klauserf1d286b2022-05-08 16:40:04 +02003456 std::__debug_db_invalidate_all(this);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003457}
3458
3459template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003460inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003461typename basic_string<_CharT, _Traits, _Allocator>::const_reference
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003462basic_string<_CharT, _Traits, _Allocator>::operator[](size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003463{
Howard Hinnant8ea98242013-08-23 17:37:05 +00003464 _LIBCPP_ASSERT(__pos <= size(), "string index out of bounds");
Howard Hinnantc51e1022010-05-11 19:42:16 +00003465 return *(data() + __pos);
3466}
3467
3468template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003469inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003470typename basic_string<_CharT, _Traits, _Allocator>::reference
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003471basic_string<_CharT, _Traits, _Allocator>::operator[](size_type __pos) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003472{
Howard Hinnant8ea98242013-08-23 17:37:05 +00003473 _LIBCPP_ASSERT(__pos <= size(), "string index out of bounds");
Howard Hinnantc51e1022010-05-11 19:42:16 +00003474 return *(__get_pointer() + __pos);
3475}
3476
3477template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003478_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003479typename basic_string<_CharT, _Traits, _Allocator>::const_reference
3480basic_string<_CharT, _Traits, _Allocator>::at(size_type __n) const
3481{
3482 if (__n >= size())
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01003483 __throw_out_of_range();
Howard Hinnantc51e1022010-05-11 19:42:16 +00003484 return (*this)[__n];
3485}
3486
3487template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003488_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003489typename basic_string<_CharT, _Traits, _Allocator>::reference
3490basic_string<_CharT, _Traits, _Allocator>::at(size_type __n)
3491{
3492 if (__n >= size())
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01003493 __throw_out_of_range();
Howard Hinnantc51e1022010-05-11 19:42:16 +00003494 return (*this)[__n];
3495}
3496
3497template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003498inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003499typename basic_string<_CharT, _Traits, _Allocator>::reference
Marshall Clow05cf6692019-03-19 03:30:07 +00003500basic_string<_CharT, _Traits, _Allocator>::front() _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003501{
Howard Hinnant8ea98242013-08-23 17:37:05 +00003502 _LIBCPP_ASSERT(!empty(), "string::front(): string is empty");
Howard Hinnantc51e1022010-05-11 19:42:16 +00003503 return *__get_pointer();
3504}
3505
3506template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003507inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003508typename basic_string<_CharT, _Traits, _Allocator>::const_reference
Marshall Clow05cf6692019-03-19 03:30:07 +00003509basic_string<_CharT, _Traits, _Allocator>::front() const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003510{
Howard Hinnant8ea98242013-08-23 17:37:05 +00003511 _LIBCPP_ASSERT(!empty(), "string::front(): string is empty");
Howard Hinnantc51e1022010-05-11 19:42:16 +00003512 return *data();
3513}
3514
3515template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003516inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003517typename basic_string<_CharT, _Traits, _Allocator>::reference
Marshall Clow05cf6692019-03-19 03:30:07 +00003518basic_string<_CharT, _Traits, _Allocator>::back() _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003519{
Howard Hinnant8ea98242013-08-23 17:37:05 +00003520 _LIBCPP_ASSERT(!empty(), "string::back(): string is empty");
Howard Hinnantc51e1022010-05-11 19:42:16 +00003521 return *(__get_pointer() + size() - 1);
3522}
3523
3524template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003525inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003526typename basic_string<_CharT, _Traits, _Allocator>::const_reference
Marshall Clow05cf6692019-03-19 03:30:07 +00003527basic_string<_CharT, _Traits, _Allocator>::back() const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003528{
Howard Hinnant8ea98242013-08-23 17:37:05 +00003529 _LIBCPP_ASSERT(!empty(), "string::back(): string is empty");
Howard Hinnantc51e1022010-05-11 19:42:16 +00003530 return *(data() + size() - 1);
3531}
3532
3533template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003534_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003535typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantd17880b2013-06-28 16:59:19 +00003536basic_string<_CharT, _Traits, _Allocator>::copy(value_type* __s, size_type __n, size_type __pos) const
Howard Hinnantc51e1022010-05-11 19:42:16 +00003537{
3538 size_type __sz = size();
3539 if (__pos > __sz)
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01003540 __throw_out_of_range();
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02003541 size_type __rlen = std::min(__n, __sz - __pos);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003542 traits_type::copy(__s, data() + __pos, __rlen);
3543 return __rlen;
3544}
3545
3546template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003547inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003548basic_string<_CharT, _Traits, _Allocator>
3549basic_string<_CharT, _Traits, _Allocator>::substr(size_type __pos, size_type __n) const
3550{
3551 return basic_string(*this, __pos, __n, __alloc());
3552}
3553
3554template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003555inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003556void
3557basic_string<_CharT, _Traits, _Allocator>::swap(basic_string& __str)
Marshall Clow8982dcd2015-07-13 20:04:56 +00003558#if _LIBCPP_STD_VER >= 14
Eric Fiselier873b8d32019-03-18 21:50:12 +00003559 _NOEXCEPT
Marshall Clow8982dcd2015-07-13 20:04:56 +00003560#else
Eric Fiselier873b8d32019-03-18 21:50:12 +00003561 _NOEXCEPT_(!__alloc_traits::propagate_on_container_swap::value ||
Marshall Clow8982dcd2015-07-13 20:04:56 +00003562 __is_nothrow_swappable<allocator_type>::value)
3563#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +00003564{
Nikolas Klauser98833542022-05-07 22:20:23 +02003565 if (!__is_long())
3566 std::__debug_db_invalidate_all(this);
3567 if (!__str.__is_long())
3568 std::__debug_db_invalidate_all(&__str);
3569 std::__debug_db_swap(this, &__str);
3570
Eric Fiselier9bf691f2016-12-28 05:53:01 +00003571 _LIBCPP_ASSERT(
3572 __alloc_traits::propagate_on_container_swap::value ||
3573 __alloc_traits::is_always_equal::value ||
3574 __alloc() == __str.__alloc(), "swapping non-equal allocators");
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02003575 std::swap(__r_.first(), __str.__r_.first());
3576 std::__swap_allocator(__alloc(), __str.__alloc());
Howard Hinnantc51e1022010-05-11 19:42:16 +00003577}
3578
3579// find
3580
3581template <class _Traits>
3582struct _LIBCPP_HIDDEN __traits_eq
3583{
3584 typedef typename _Traits::char_type char_type;
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02003585 _LIBCPP_HIDE_FROM_ABI
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003586 bool operator()(const char_type& __x, const char_type& __y) _NOEXCEPT
3587 {return _Traits::eq(__x, __y);}
Howard Hinnantc51e1022010-05-11 19:42:16 +00003588};
3589
3590template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003591_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003592typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantd17880b2013-06-28 16:59:19 +00003593basic_string<_CharT, _Traits, _Allocator>::find(const value_type* __s,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003594 size_type __pos,
3595 size_type __n) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003596{
Alp Tokerb8a95f52014-05-15 11:27:39 +00003597 _LIBCPP_ASSERT(__n == 0 || __s != nullptr, "string::find(): received nullptr");
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003598 return __str_find<value_type, size_type, traits_type, npos>
Marshall Clowc527b6e2014-06-02 02:22:49 +00003599 (data(), size(), __s, __pos, __n);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003600}
3601
3602template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003603inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003604typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003605basic_string<_CharT, _Traits, _Allocator>::find(const basic_string& __str,
3606 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003607{
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003608 return __str_find<value_type, size_type, traits_type, npos>
Marshall Clowc527b6e2014-06-02 02:22:49 +00003609 (data(), size(), __str.data(), __pos, __str.size());
Howard Hinnantc51e1022010-05-11 19:42:16 +00003610}
3611
3612template<class _CharT, class _Traits, class _Allocator>
Marshall Clowe46031a2018-07-02 18:41:15 +00003613template <class _Tp>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003614_LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04003615__enable_if_t
Marshall Clowe46031a2018-07-02 18:41:15 +00003616<
3617 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
3618 typename basic_string<_CharT, _Traits, _Allocator>::size_type
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003619>
Marshall Clowe46031a2018-07-02 18:41:15 +00003620basic_string<_CharT, _Traits, _Allocator>::find(const _Tp &__t,
zoecarver1997e0a2021-02-05 11:54:47 -08003621 size_type __pos) const _NOEXCEPT
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003622{
Marshall Clowe46031a2018-07-02 18:41:15 +00003623 __self_view __sv = __t;
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003624 return __str_find<value_type, size_type, traits_type, npos>
3625 (data(), size(), __sv.data(), __pos, __sv.size());
3626}
3627
3628template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003629inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003630typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantd17880b2013-06-28 16:59:19 +00003631basic_string<_CharT, _Traits, _Allocator>::find(const value_type* __s,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003632 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003633{
Alp Tokerb8a95f52014-05-15 11:27:39 +00003634 _LIBCPP_ASSERT(__s != nullptr, "string::find(): received nullptr");
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003635 return __str_find<value_type, size_type, traits_type, npos>
Marshall Clowc527b6e2014-06-02 02:22:49 +00003636 (data(), size(), __s, __pos, traits_type::length(__s));
Howard Hinnantc51e1022010-05-11 19:42:16 +00003637}
3638
3639template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003640_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003641typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003642basic_string<_CharT, _Traits, _Allocator>::find(value_type __c,
3643 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003644{
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003645 return __str_find<value_type, size_type, traits_type, npos>
Marshall Clowc527b6e2014-06-02 02:22:49 +00003646 (data(), size(), __c, __pos);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003647}
3648
3649// rfind
3650
3651template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003652_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003653typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantd17880b2013-06-28 16:59:19 +00003654basic_string<_CharT, _Traits, _Allocator>::rfind(const value_type* __s,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003655 size_type __pos,
3656 size_type __n) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003657{
Alp Tokerb8a95f52014-05-15 11:27:39 +00003658 _LIBCPP_ASSERT(__n == 0 || __s != nullptr, "string::rfind(): received nullptr");
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003659 return __str_rfind<value_type, size_type, traits_type, npos>
Marshall Clowc527b6e2014-06-02 02:22:49 +00003660 (data(), size(), __s, __pos, __n);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003661}
3662
3663template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003664inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003665typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003666basic_string<_CharT, _Traits, _Allocator>::rfind(const basic_string& __str,
3667 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003668{
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003669 return __str_rfind<value_type, size_type, traits_type, npos>
Marshall Clowc527b6e2014-06-02 02:22:49 +00003670 (data(), size(), __str.data(), __pos, __str.size());
Howard Hinnantc51e1022010-05-11 19:42:16 +00003671}
3672
3673template<class _CharT, class _Traits, class _Allocator>
Marshall Clowe46031a2018-07-02 18:41:15 +00003674template <class _Tp>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003675_LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04003676__enable_if_t
Marshall Clowe46031a2018-07-02 18:41:15 +00003677<
3678 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
3679 typename basic_string<_CharT, _Traits, _Allocator>::size_type
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003680>
Marshall Clowe46031a2018-07-02 18:41:15 +00003681basic_string<_CharT, _Traits, _Allocator>::rfind(const _Tp& __t,
zoecarver1997e0a2021-02-05 11:54:47 -08003682 size_type __pos) const _NOEXCEPT
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003683{
Marshall Clowe46031a2018-07-02 18:41:15 +00003684 __self_view __sv = __t;
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003685 return __str_rfind<value_type, size_type, traits_type, npos>
3686 (data(), size(), __sv.data(), __pos, __sv.size());
3687}
3688
3689template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003690inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003691typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantd17880b2013-06-28 16:59:19 +00003692basic_string<_CharT, _Traits, _Allocator>::rfind(const value_type* __s,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003693 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003694{
Alp Tokerb8a95f52014-05-15 11:27:39 +00003695 _LIBCPP_ASSERT(__s != nullptr, "string::rfind(): received nullptr");
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003696 return __str_rfind<value_type, size_type, traits_type, npos>
Marshall Clowc527b6e2014-06-02 02:22:49 +00003697 (data(), size(), __s, __pos, traits_type::length(__s));
Howard Hinnantc51e1022010-05-11 19:42:16 +00003698}
3699
3700template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003701_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003702typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003703basic_string<_CharT, _Traits, _Allocator>::rfind(value_type __c,
3704 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003705{
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003706 return __str_rfind<value_type, size_type, traits_type, npos>
Marshall Clowc527b6e2014-06-02 02:22:49 +00003707 (data(), size(), __c, __pos);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003708}
3709
3710// find_first_of
3711
3712template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003713_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003714typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantd17880b2013-06-28 16:59:19 +00003715basic_string<_CharT, _Traits, _Allocator>::find_first_of(const value_type* __s,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003716 size_type __pos,
3717 size_type __n) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003718{
Alp Tokerb8a95f52014-05-15 11:27:39 +00003719 _LIBCPP_ASSERT(__n == 0 || __s != nullptr, "string::find_first_of(): received nullptr");
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003720 return __str_find_first_of<value_type, size_type, traits_type, npos>
Marshall Clow4bc2be22014-02-16 01:57:26 +00003721 (data(), size(), __s, __pos, __n);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003722}
3723
3724template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003725inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003726typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003727basic_string<_CharT, _Traits, _Allocator>::find_first_of(const basic_string& __str,
3728 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003729{
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003730 return __str_find_first_of<value_type, size_type, traits_type, npos>
Marshall Clow4bc2be22014-02-16 01:57:26 +00003731 (data(), size(), __str.data(), __pos, __str.size());
Howard Hinnantc51e1022010-05-11 19:42:16 +00003732}
3733
3734template<class _CharT, class _Traits, class _Allocator>
Marshall Clowe46031a2018-07-02 18:41:15 +00003735template <class _Tp>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003736_LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04003737__enable_if_t
Marshall Clowe46031a2018-07-02 18:41:15 +00003738<
3739 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
3740 typename basic_string<_CharT, _Traits, _Allocator>::size_type
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003741>
Marshall Clowe46031a2018-07-02 18:41:15 +00003742basic_string<_CharT, _Traits, _Allocator>::find_first_of(const _Tp& __t,
zoecarver1997e0a2021-02-05 11:54:47 -08003743 size_type __pos) const _NOEXCEPT
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003744{
Marshall Clowe46031a2018-07-02 18:41:15 +00003745 __self_view __sv = __t;
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003746 return __str_find_first_of<value_type, size_type, traits_type, npos>
3747 (data(), size(), __sv.data(), __pos, __sv.size());
3748}
3749
3750template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003751inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003752typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantd17880b2013-06-28 16:59:19 +00003753basic_string<_CharT, _Traits, _Allocator>::find_first_of(const value_type* __s,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003754 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003755{
Alp Tokerb8a95f52014-05-15 11:27:39 +00003756 _LIBCPP_ASSERT(__s != nullptr, "string::find_first_of(): received nullptr");
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003757 return __str_find_first_of<value_type, size_type, traits_type, npos>
Marshall Clow4bc2be22014-02-16 01:57:26 +00003758 (data(), size(), __s, __pos, traits_type::length(__s));
Howard Hinnantc51e1022010-05-11 19:42:16 +00003759}
3760
3761template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003762inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003763typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003764basic_string<_CharT, _Traits, _Allocator>::find_first_of(value_type __c,
3765 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003766{
3767 return find(__c, __pos);
3768}
3769
3770// find_last_of
3771
3772template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003773inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003774typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantd17880b2013-06-28 16:59:19 +00003775basic_string<_CharT, _Traits, _Allocator>::find_last_of(const value_type* __s,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003776 size_type __pos,
3777 size_type __n) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003778{
Alp Tokerb8a95f52014-05-15 11:27:39 +00003779 _LIBCPP_ASSERT(__n == 0 || __s != nullptr, "string::find_last_of(): received nullptr");
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003780 return __str_find_last_of<value_type, size_type, traits_type, npos>
Marshall Clow4bc2be22014-02-16 01:57:26 +00003781 (data(), size(), __s, __pos, __n);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003782}
3783
3784template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003785inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003786typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003787basic_string<_CharT, _Traits, _Allocator>::find_last_of(const basic_string& __str,
3788 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003789{
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003790 return __str_find_last_of<value_type, size_type, traits_type, npos>
Marshall Clow4bc2be22014-02-16 01:57:26 +00003791 (data(), size(), __str.data(), __pos, __str.size());
Howard Hinnantc51e1022010-05-11 19:42:16 +00003792}
3793
3794template<class _CharT, class _Traits, class _Allocator>
Marshall Clowe46031a2018-07-02 18:41:15 +00003795template <class _Tp>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003796_LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04003797__enable_if_t
Marshall Clowe46031a2018-07-02 18:41:15 +00003798<
3799 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
3800 typename basic_string<_CharT, _Traits, _Allocator>::size_type
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003801>
Marshall Clowe46031a2018-07-02 18:41:15 +00003802basic_string<_CharT, _Traits, _Allocator>::find_last_of(const _Tp& __t,
zoecarver1997e0a2021-02-05 11:54:47 -08003803 size_type __pos) const _NOEXCEPT
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003804{
Marshall Clowe46031a2018-07-02 18:41:15 +00003805 __self_view __sv = __t;
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003806 return __str_find_last_of<value_type, size_type, traits_type, npos>
3807 (data(), size(), __sv.data(), __pos, __sv.size());
3808}
3809
3810template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003811inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003812typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantd17880b2013-06-28 16:59:19 +00003813basic_string<_CharT, _Traits, _Allocator>::find_last_of(const value_type* __s,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003814 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003815{
Alp Tokerb8a95f52014-05-15 11:27:39 +00003816 _LIBCPP_ASSERT(__s != nullptr, "string::find_last_of(): received nullptr");
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003817 return __str_find_last_of<value_type, size_type, traits_type, npos>
Marshall Clow4bc2be22014-02-16 01:57:26 +00003818 (data(), size(), __s, __pos, traits_type::length(__s));
Howard Hinnantc51e1022010-05-11 19:42:16 +00003819}
3820
3821template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003822inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003823typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003824basic_string<_CharT, _Traits, _Allocator>::find_last_of(value_type __c,
3825 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003826{
3827 return rfind(__c, __pos);
3828}
3829
3830// find_first_not_of
3831
3832template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003833_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003834typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantd17880b2013-06-28 16:59:19 +00003835basic_string<_CharT, _Traits, _Allocator>::find_first_not_of(const value_type* __s,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003836 size_type __pos,
3837 size_type __n) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003838{
Alp Tokerb8a95f52014-05-15 11:27:39 +00003839 _LIBCPP_ASSERT(__n == 0 || __s != nullptr, "string::find_first_not_of(): received nullptr");
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003840 return __str_find_first_not_of<value_type, size_type, traits_type, npos>
Marshall Clow4bc2be22014-02-16 01:57:26 +00003841 (data(), size(), __s, __pos, __n);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003842}
3843
3844template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003845inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003846typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003847basic_string<_CharT, _Traits, _Allocator>::find_first_not_of(const basic_string& __str,
3848 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003849{
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003850 return __str_find_first_not_of<value_type, size_type, traits_type, npos>
Marshall Clow4bc2be22014-02-16 01:57:26 +00003851 (data(), size(), __str.data(), __pos, __str.size());
Howard Hinnantc51e1022010-05-11 19:42:16 +00003852}
3853
3854template<class _CharT, class _Traits, class _Allocator>
Marshall Clowe46031a2018-07-02 18:41:15 +00003855template <class _Tp>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003856_LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04003857__enable_if_t
Marshall Clowe46031a2018-07-02 18:41:15 +00003858<
3859 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
3860 typename basic_string<_CharT, _Traits, _Allocator>::size_type
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003861>
Marshall Clowe46031a2018-07-02 18:41:15 +00003862basic_string<_CharT, _Traits, _Allocator>::find_first_not_of(const _Tp& __t,
zoecarver1997e0a2021-02-05 11:54:47 -08003863 size_type __pos) const _NOEXCEPT
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003864{
Marshall Clowe46031a2018-07-02 18:41:15 +00003865 __self_view __sv = __t;
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003866 return __str_find_first_not_of<value_type, size_type, traits_type, npos>
3867 (data(), size(), __sv.data(), __pos, __sv.size());
3868}
3869
3870template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003871inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003872typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantd17880b2013-06-28 16:59:19 +00003873basic_string<_CharT, _Traits, _Allocator>::find_first_not_of(const value_type* __s,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003874 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003875{
Alp Tokerb8a95f52014-05-15 11:27:39 +00003876 _LIBCPP_ASSERT(__s != nullptr, "string::find_first_not_of(): received nullptr");
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003877 return __str_find_first_not_of<value_type, size_type, traits_type, npos>
Marshall Clow4bc2be22014-02-16 01:57:26 +00003878 (data(), size(), __s, __pos, traits_type::length(__s));
Howard Hinnantc51e1022010-05-11 19:42:16 +00003879}
3880
3881template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003882inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003883typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003884basic_string<_CharT, _Traits, _Allocator>::find_first_not_of(value_type __c,
3885 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003886{
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003887 return __str_find_first_not_of<value_type, size_type, traits_type, npos>
Marshall Clow4bc2be22014-02-16 01:57:26 +00003888 (data(), size(), __c, __pos);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003889}
3890
3891// find_last_not_of
3892
3893template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003894_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003895typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantd17880b2013-06-28 16:59:19 +00003896basic_string<_CharT, _Traits, _Allocator>::find_last_not_of(const value_type* __s,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003897 size_type __pos,
3898 size_type __n) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003899{
Alp Tokerb8a95f52014-05-15 11:27:39 +00003900 _LIBCPP_ASSERT(__n == 0 || __s != nullptr, "string::find_last_not_of(): received nullptr");
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003901 return __str_find_last_not_of<value_type, size_type, traits_type, npos>
Marshall Clow4bc2be22014-02-16 01:57:26 +00003902 (data(), size(), __s, __pos, __n);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003903}
3904
3905template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003906inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003907typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003908basic_string<_CharT, _Traits, _Allocator>::find_last_not_of(const basic_string& __str,
3909 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003910{
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003911 return __str_find_last_not_of<value_type, size_type, traits_type, npos>
Marshall Clow4bc2be22014-02-16 01:57:26 +00003912 (data(), size(), __str.data(), __pos, __str.size());
Howard Hinnantc51e1022010-05-11 19:42:16 +00003913}
3914
3915template<class _CharT, class _Traits, class _Allocator>
Marshall Clowe46031a2018-07-02 18:41:15 +00003916template <class _Tp>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003917_LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04003918__enable_if_t
Marshall Clowe46031a2018-07-02 18:41:15 +00003919<
3920 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
3921 typename basic_string<_CharT, _Traits, _Allocator>::size_type
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003922>
Marshall Clowe46031a2018-07-02 18:41:15 +00003923basic_string<_CharT, _Traits, _Allocator>::find_last_not_of(const _Tp& __t,
zoecarver1997e0a2021-02-05 11:54:47 -08003924 size_type __pos) const _NOEXCEPT
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003925{
Marshall Clowe46031a2018-07-02 18:41:15 +00003926 __self_view __sv = __t;
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003927 return __str_find_last_not_of<value_type, size_type, traits_type, npos>
3928 (data(), size(), __sv.data(), __pos, __sv.size());
3929}
3930
3931template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003932inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003933typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantd17880b2013-06-28 16:59:19 +00003934basic_string<_CharT, _Traits, _Allocator>::find_last_not_of(const value_type* __s,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003935 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003936{
Alp Tokerb8a95f52014-05-15 11:27:39 +00003937 _LIBCPP_ASSERT(__s != nullptr, "string::find_last_not_of(): received nullptr");
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003938 return __str_find_last_not_of<value_type, size_type, traits_type, npos>
Marshall Clow4bc2be22014-02-16 01:57:26 +00003939 (data(), size(), __s, __pos, traits_type::length(__s));
Howard Hinnantc51e1022010-05-11 19:42:16 +00003940}
3941
3942template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003943inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003944typename basic_string<_CharT, _Traits, _Allocator>::size_type
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003945basic_string<_CharT, _Traits, _Allocator>::find_last_not_of(value_type __c,
3946 size_type __pos) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003947{
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003948 return __str_find_last_not_of<value_type, size_type, traits_type, npos>
Marshall Clow4bc2be22014-02-16 01:57:26 +00003949 (data(), size(), __c, __pos);
Howard Hinnantc51e1022010-05-11 19:42:16 +00003950}
3951
3952// compare
3953
3954template <class _CharT, class _Traits, class _Allocator>
Marshall Clowe46031a2018-07-02 18:41:15 +00003955template <class _Tp>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003956_LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04003957__enable_if_t
Marshall Clowe46031a2018-07-02 18:41:15 +00003958<
3959 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
3960 int
Eric Fiselierc522ceb2020-01-15 16:57:08 -05003961>
zoecarver1997e0a2021-02-05 11:54:47 -08003962basic_string<_CharT, _Traits, _Allocator>::compare(const _Tp& __t) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003963{
Marshall Clowe46031a2018-07-02 18:41:15 +00003964 __self_view __sv = __t;
Howard Hinnantb0485532011-07-24 21:45:06 +00003965 size_t __lhs_sz = size();
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003966 size_t __rhs_sz = __sv.size();
3967 int __result = traits_type::compare(data(), __sv.data(),
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02003968 std::min(__lhs_sz, __rhs_sz));
Howard Hinnantb0485532011-07-24 21:45:06 +00003969 if (__result != 0)
3970 return __result;
3971 if (__lhs_sz < __rhs_sz)
3972 return -1;
3973 if (__lhs_sz > __rhs_sz)
3974 return 1;
3975 return 0;
Howard Hinnantc51e1022010-05-11 19:42:16 +00003976}
3977
3978template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003979inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003980int
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003981basic_string<_CharT, _Traits, _Allocator>::compare(const basic_string& __str) const _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00003982{
Marshall Clowdf63a6d2016-07-21 05:31:24 +00003983 return compare(__self_view(__str));
Howard Hinnantc51e1022010-05-11 19:42:16 +00003984}
3985
3986template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02003987inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00003988int
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003989basic_string<_CharT, _Traits, _Allocator>::compare(size_type __pos1,
3990 size_type __n1,
Howard Hinnantd17880b2013-06-28 16:59:19 +00003991 const value_type* __s,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00003992 size_type __n2) const
Howard Hinnantc51e1022010-05-11 19:42:16 +00003993{
Alp Tokerb8a95f52014-05-15 11:27:39 +00003994 _LIBCPP_ASSERT(__n2 == 0 || __s != nullptr, "string::compare(): received nullptr");
Howard Hinnantc51e1022010-05-11 19:42:16 +00003995 size_type __sz = size();
3996 if (__pos1 > __sz || __n2 == npos)
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01003997 __throw_out_of_range();
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02003998 size_type __rlen = std::min(__n1, __sz - __pos1);
3999 int __r = traits_type::compare(data() + __pos1, __s, std::min(__rlen, __n2));
Howard Hinnantc51e1022010-05-11 19:42:16 +00004000 if (__r == 0)
4001 {
4002 if (__rlen < __n2)
4003 __r = -1;
4004 else if (__rlen > __n2)
4005 __r = 1;
4006 }
4007 return __r;
4008}
4009
Marshall Clowdf63a6d2016-07-21 05:31:24 +00004010template <class _CharT, class _Traits, class _Allocator>
Marshall Clowe46031a2018-07-02 18:41:15 +00004011template <class _Tp>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02004012_LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04004013__enable_if_t
Marshall Clowe46031a2018-07-02 18:41:15 +00004014<
4015 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value,
4016 int
Eric Fiselierc522ceb2020-01-15 16:57:08 -05004017>
Marshall Clowdf63a6d2016-07-21 05:31:24 +00004018basic_string<_CharT, _Traits, _Allocator>::compare(size_type __pos1,
4019 size_type __n1,
Marshall Clowe46031a2018-07-02 18:41:15 +00004020 const _Tp& __t) const
Marshall Clowdf63a6d2016-07-21 05:31:24 +00004021{
Marshall Clowe46031a2018-07-02 18:41:15 +00004022 __self_view __sv = __t;
Marshall Clowdf63a6d2016-07-21 05:31:24 +00004023 return compare(__pos1, __n1, __sv.data(), __sv.size());
4024}
4025
4026template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02004027inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Marshall Clowdf63a6d2016-07-21 05:31:24 +00004028int
4029basic_string<_CharT, _Traits, _Allocator>::compare(size_type __pos1,
4030 size_type __n1,
4031 const basic_string& __str) const
4032{
4033 return compare(__pos1, __n1, __str.data(), __str.size());
4034}
4035
4036template <class _CharT, class _Traits, class _Allocator>
Marshall Clow82513342016-09-24 22:45:42 +00004037template <class _Tp>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02004038_LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne9ce598d2021-09-08 09:14:43 -04004039__enable_if_t
Marshall Clow82513342016-09-24 22:45:42 +00004040<
Eric Fiselierc522ceb2020-01-15 16:57:08 -05004041 __can_be_converted_to_string_view<_CharT, _Traits, _Tp>::value
4042 && !__is_same_uncvref<_Tp, basic_string<_CharT, _Traits, _Allocator> >::value,
Marshall Clowb7db4972017-11-15 20:02:27 +00004043 int
Eric Fiselierc522ceb2020-01-15 16:57:08 -05004044>
Marshall Clowdf63a6d2016-07-21 05:31:24 +00004045basic_string<_CharT, _Traits, _Allocator>::compare(size_type __pos1,
4046 size_type __n1,
Marshall Clow82513342016-09-24 22:45:42 +00004047 const _Tp& __t,
Marshall Clowdf63a6d2016-07-21 05:31:24 +00004048 size_type __pos2,
4049 size_type __n2) const
4050{
Marshall Clow82513342016-09-24 22:45:42 +00004051 __self_view __sv = __t;
Marshall Clowdf63a6d2016-07-21 05:31:24 +00004052 return __self_view(*this).substr(__pos1, __n1).compare(__sv.substr(__pos2, __n2));
4053}
4054
4055template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02004056_LIBCPP_CONSTEXPR_AFTER_CXX17
Marshall Clowdf63a6d2016-07-21 05:31:24 +00004057int
4058basic_string<_CharT, _Traits, _Allocator>::compare(size_type __pos1,
4059 size_type __n1,
4060 const basic_string& __str,
4061 size_type __pos2,
4062 size_type __n2) const
4063{
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01004064 return compare(__pos1, __n1, __self_view(__str), __pos2, __n2);
Marshall Clowdf63a6d2016-07-21 05:31:24 +00004065}
4066
4067template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02004068_LIBCPP_CONSTEXPR_AFTER_CXX17
Marshall Clowdf63a6d2016-07-21 05:31:24 +00004069int
4070basic_string<_CharT, _Traits, _Allocator>::compare(const value_type* __s) const _NOEXCEPT
4071{
4072 _LIBCPP_ASSERT(__s != nullptr, "string::compare(): received nullptr");
4073 return compare(0, npos, __s, traits_type::length(__s));
4074}
4075
4076template <class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02004077_LIBCPP_CONSTEXPR_AFTER_CXX17
Marshall Clowdf63a6d2016-07-21 05:31:24 +00004078int
4079basic_string<_CharT, _Traits, _Allocator>::compare(size_type __pos1,
4080 size_type __n1,
4081 const value_type* __s) const
4082{
4083 _LIBCPP_ASSERT(__s != nullptr, "string::compare(): received nullptr");
4084 return compare(__pos1, __n1, __s, traits_type::length(__s));
4085}
4086
Howard Hinnantc51e1022010-05-11 19:42:16 +00004087// __invariants
4088
4089template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02004090inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00004091bool
4092basic_string<_CharT, _Traits, _Allocator>::__invariants() const
4093{
4094 if (size() > capacity())
4095 return false;
4096 if (capacity() < __min_cap - 1)
4097 return false;
Bruce Mitchener170d8972020-11-24 12:53:53 -05004098 if (data() == nullptr)
Howard Hinnantc51e1022010-05-11 19:42:16 +00004099 return false;
Louis Dionne663415f2020-10-05 16:16:13 -04004100 if (data()[size()] != value_type())
Howard Hinnantc51e1022010-05-11 19:42:16 +00004101 return false;
4102 return true;
4103}
4104
Vedant Kumar55e007e2018-03-08 21:15:26 +00004105// __clear_and_shrink
4106
4107template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02004108inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Louis Dionne173f29e2019-05-29 16:01:36 +00004109void
Marshall Clowe60a7182018-05-29 17:04:37 +00004110basic_string<_CharT, _Traits, _Allocator>::__clear_and_shrink() _NOEXCEPT
Vedant Kumar55e007e2018-03-08 21:15:26 +00004111{
4112 clear();
4113 if(__is_long())
4114 {
4115 __alloc_traits::deallocate(__alloc(), __get_long_pointer(), capacity() + 1);
4116 __set_long_cap(0);
4117 __set_short_size(0);
Louis Dionne663415f2020-10-05 16:16:13 -04004118 traits_type::assign(*__get_short_pointer(), value_type());
Vedant Kumar55e007e2018-03-08 21:15:26 +00004119 }
Louis Dionne173f29e2019-05-29 16:01:36 +00004120}
Vedant Kumar55e007e2018-03-08 21:15:26 +00004121
Howard Hinnantc51e1022010-05-11 19:42:16 +00004122// operator==
4123
4124template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004125inline _LIBCPP_CONSTEXPR_AFTER_CXX17 _LIBCPP_HIDE_FROM_ABI
Howard Hinnantc51e1022010-05-11 19:42:16 +00004126bool
4127operator==(const basic_string<_CharT, _Traits, _Allocator>& __lhs,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004128 const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004129{
Howard Hinnantaaeb1132013-04-22 23:55:13 +00004130 size_t __lhs_sz = __lhs.size();
4131 return __lhs_sz == __rhs.size() && _Traits::compare(__lhs.data(),
4132 __rhs.data(),
4133 __lhs_sz) == 0;
4134}
4135
4136template<class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004137inline _LIBCPP_CONSTEXPR_AFTER_CXX17 _LIBCPP_HIDE_FROM_ABI
Howard Hinnantaaeb1132013-04-22 23:55:13 +00004138bool
4139operator==(const basic_string<char, char_traits<char>, _Allocator>& __lhs,
4140 const basic_string<char, char_traits<char>, _Allocator>& __rhs) _NOEXCEPT
4141{
4142 size_t __lhs_sz = __lhs.size();
4143 if (__lhs_sz != __rhs.size())
4144 return false;
4145 const char* __lp = __lhs.data();
4146 const char* __rp = __rhs.data();
4147 if (__lhs.__is_long())
4148 return char_traits<char>::compare(__lp, __rp, __lhs_sz) == 0;
4149 for (; __lhs_sz != 0; --__lhs_sz, ++__lp, ++__rp)
4150 if (*__lp != *__rp)
4151 return false;
4152 return true;
Howard Hinnantc51e1022010-05-11 19:42:16 +00004153}
4154
4155template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004156inline _LIBCPP_CONSTEXPR_AFTER_CXX17 _LIBCPP_HIDE_FROM_ABI
Howard Hinnantc51e1022010-05-11 19:42:16 +00004157bool
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004158operator==(const _CharT* __lhs,
4159 const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004160{
Eric Fiselier0cafa3f2015-08-28 03:02:37 +00004161 typedef basic_string<_CharT, _Traits, _Allocator> _String;
4162 _LIBCPP_ASSERT(__lhs != nullptr, "operator==(char*, basic_string): received nullptr");
4163 size_t __lhs_len = _Traits::length(__lhs);
4164 if (__lhs_len != __rhs.size()) return false;
4165 return __rhs.compare(0, _String::npos, __lhs, __lhs_len) == 0;
Howard Hinnantc51e1022010-05-11 19:42:16 +00004166}
4167
Howard Hinnantc51e1022010-05-11 19:42:16 +00004168template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004169inline _LIBCPP_CONSTEXPR_AFTER_CXX17 _LIBCPP_HIDE_FROM_ABI
Howard Hinnantc51e1022010-05-11 19:42:16 +00004170bool
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004171operator==(const basic_string<_CharT,_Traits,_Allocator>& __lhs,
4172 const _CharT* __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004173{
Eric Fiselier0cafa3f2015-08-28 03:02:37 +00004174 typedef basic_string<_CharT, _Traits, _Allocator> _String;
4175 _LIBCPP_ASSERT(__rhs != nullptr, "operator==(basic_string, char*): received nullptr");
4176 size_t __rhs_len = _Traits::length(__rhs);
4177 if (__rhs_len != __lhs.size()) return false;
4178 return __lhs.compare(0, _String::npos, __rhs, __rhs_len) == 0;
Howard Hinnantc51e1022010-05-11 19:42:16 +00004179}
4180
Howard Hinnant3b6579a2010-08-22 00:02:43 +00004181template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004182inline _LIBCPP_CONSTEXPR_AFTER_CXX17 _LIBCPP_HIDE_FROM_ABI
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 !(__lhs == __rhs);
4188}
4189
4190template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004191inline _LIBCPP_CONSTEXPR_AFTER_CXX17 _LIBCPP_HIDE_FROM_ABI
Howard Hinnantc51e1022010-05-11 19:42:16 +00004192bool
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004193operator!=(const _CharT* __lhs,
4194 const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004195{
4196 return !(__lhs == __rhs);
4197}
4198
4199template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004200inline _LIBCPP_CONSTEXPR_AFTER_CXX17 _LIBCPP_HIDE_FROM_ABI
Howard Hinnantc51e1022010-05-11 19:42:16 +00004201bool
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004202operator!=(const basic_string<_CharT, _Traits, _Allocator>& __lhs,
4203 const _CharT* __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004204{
4205 return !(__lhs == __rhs);
4206}
4207
4208// operator<
4209
4210template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004211inline _LIBCPP_CONSTEXPR_AFTER_CXX17 _LIBCPP_HIDE_FROM_ABI
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{
Howard Hinnanta2660c12011-07-24 15:07:21 +00004216 return __lhs.compare(__rhs) < 0;
Howard Hinnantc51e1022010-05-11 19:42:16 +00004217}
4218
4219template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004220inline _LIBCPP_CONSTEXPR_AFTER_CXX17 _LIBCPP_HIDE_FROM_ABI
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{
Howard Hinnanta2660c12011-07-24 15:07:21 +00004225 return __lhs.compare(__rhs) < 0;
Howard Hinnantc51e1022010-05-11 19:42:16 +00004226}
4227
4228template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004229inline _LIBCPP_CONSTEXPR_AFTER_CXX17 _LIBCPP_HIDE_FROM_ABI
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 __rhs.compare(__lhs) > 0;
4235}
4236
Howard Hinnantc51e1022010-05-11 19:42:16 +00004237// operator>
4238
4239template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004240inline _LIBCPP_CONSTEXPR_AFTER_CXX17 _LIBCPP_HIDE_FROM_ABI
Howard Hinnantc51e1022010-05-11 19:42:16 +00004241bool
4242operator> (const basic_string<_CharT, _Traits, _Allocator>& __lhs,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004243 const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004244{
4245 return __rhs < __lhs;
4246}
4247
4248template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004249inline _LIBCPP_CONSTEXPR_AFTER_CXX17 _LIBCPP_HIDE_FROM_ABI
Howard Hinnantc51e1022010-05-11 19:42:16 +00004250bool
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004251operator> (const basic_string<_CharT, _Traits, _Allocator>& __lhs,
4252 const _CharT* __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004253{
4254 return __rhs < __lhs;
4255}
4256
4257template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004258inline _LIBCPP_CONSTEXPR_AFTER_CXX17 _LIBCPP_HIDE_FROM_ABI
Howard Hinnantc51e1022010-05-11 19:42:16 +00004259bool
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004260operator> (const _CharT* __lhs,
4261 const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004262{
4263 return __rhs < __lhs;
4264}
4265
4266// operator<=
4267
4268template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004269inline _LIBCPP_CONSTEXPR_AFTER_CXX17 _LIBCPP_HIDE_FROM_ABI
Howard Hinnantc51e1022010-05-11 19:42:16 +00004270bool
4271operator<=(const basic_string<_CharT, _Traits, _Allocator>& __lhs,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004272 const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004273{
4274 return !(__rhs < __lhs);
4275}
4276
4277template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004278inline _LIBCPP_CONSTEXPR_AFTER_CXX17 _LIBCPP_HIDE_FROM_ABI
Howard Hinnantc51e1022010-05-11 19:42:16 +00004279bool
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004280operator<=(const basic_string<_CharT, _Traits, _Allocator>& __lhs,
4281 const _CharT* __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004282{
4283 return !(__rhs < __lhs);
4284}
4285
4286template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004287inline _LIBCPP_CONSTEXPR_AFTER_CXX17 _LIBCPP_HIDE_FROM_ABI
Howard Hinnantc51e1022010-05-11 19:42:16 +00004288bool
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004289operator<=(const _CharT* __lhs,
4290 const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004291{
4292 return !(__rhs < __lhs);
4293}
4294
4295// operator>=
4296
4297template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004298inline _LIBCPP_CONSTEXPR_AFTER_CXX17 _LIBCPP_HIDE_FROM_ABI
Howard Hinnantc51e1022010-05-11 19:42:16 +00004299bool
4300operator>=(const basic_string<_CharT, _Traits, _Allocator>& __lhs,
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004301 const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004302{
4303 return !(__lhs < __rhs);
4304}
4305
4306template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004307inline _LIBCPP_CONSTEXPR_AFTER_CXX17 _LIBCPP_HIDE_FROM_ABI
Howard Hinnantc51e1022010-05-11 19:42:16 +00004308bool
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004309operator>=(const basic_string<_CharT, _Traits, _Allocator>& __lhs,
4310 const _CharT* __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004311{
4312 return !(__lhs < __rhs);
4313}
4314
4315template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004316inline _LIBCPP_CONSTEXPR_AFTER_CXX17 _LIBCPP_HIDE_FROM_ABI
Howard Hinnantc51e1022010-05-11 19:42:16 +00004317bool
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004318operator>=(const _CharT* __lhs,
4319 const basic_string<_CharT, _Traits, _Allocator>& __rhs) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +00004320{
4321 return !(__lhs < __rhs);
4322}
4323
4324// operator +
4325
4326template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02004327_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00004328basic_string<_CharT, _Traits, _Allocator>
4329operator+(const basic_string<_CharT, _Traits, _Allocator>& __lhs,
4330 const basic_string<_CharT, _Traits, _Allocator>& __rhs)
4331{
Nikolas Klauser38631bf2022-02-11 19:24:31 +01004332 using _String = basic_string<_CharT, _Traits, _Allocator>;
Nikolas Klauser55dc8082022-04-09 16:19:45 +02004333 auto __lhs_sz = __lhs.size();
4334 auto __rhs_sz = __rhs.size();
4335 _String __r(__uninitialized_size_tag(),
4336 __lhs_sz + __rhs_sz,
4337 _String::__alloc_traits::select_on_container_copy_construction(__lhs.get_allocator()));
4338 auto __ptr = std::__to_address(__r.__get_pointer());
4339 _Traits::copy(__ptr, __lhs.data(), __lhs_sz);
4340 _Traits::copy(__ptr + __lhs_sz, __rhs.data(), __rhs_sz);
4341 _Traits::assign(__ptr + __lhs_sz + __rhs_sz, 1, _CharT());
Howard Hinnantc51e1022010-05-11 19:42:16 +00004342 return __r;
4343}
4344
4345template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02004346_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00004347basic_string<_CharT, _Traits, _Allocator>
4348operator+(const _CharT* __lhs , const basic_string<_CharT,_Traits,_Allocator>& __rhs)
4349{
Nikolas Klauser38631bf2022-02-11 19:24:31 +01004350 using _String = basic_string<_CharT, _Traits, _Allocator>;
Nikolas Klauser55dc8082022-04-09 16:19:45 +02004351 auto __lhs_sz = _Traits::length(__lhs);
4352 auto __rhs_sz = __rhs.size();
4353 _String __r(__uninitialized_size_tag(),
4354 __lhs_sz + __rhs_sz,
4355 _String::__alloc_traits::select_on_container_copy_construction(__rhs.get_allocator()));
4356 auto __ptr = std::__to_address(__r.__get_pointer());
4357 _Traits::copy(__ptr, __lhs, __lhs_sz);
4358 _Traits::copy(__ptr + __lhs_sz, __rhs.data(), __rhs_sz);
4359 _Traits::assign(__ptr + __lhs_sz + __rhs_sz, 1, _CharT());
Howard Hinnantc51e1022010-05-11 19:42:16 +00004360 return __r;
4361}
4362
4363template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02004364_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00004365basic_string<_CharT, _Traits, _Allocator>
4366operator+(_CharT __lhs, const basic_string<_CharT,_Traits,_Allocator>& __rhs)
4367{
Nikolas Klauser38631bf2022-02-11 19:24:31 +01004368 using _String = basic_string<_CharT, _Traits, _Allocator>;
Nikolas Klauser38631bf2022-02-11 19:24:31 +01004369 typename _String::size_type __rhs_sz = __rhs.size();
Nikolas Klauser55dc8082022-04-09 16:19:45 +02004370 _String __r(__uninitialized_size_tag(),
4371 __rhs_sz + 1,
4372 _String::__alloc_traits::select_on_container_copy_construction(__rhs.get_allocator()));
4373 auto __ptr = std::__to_address(__r.__get_pointer());
4374 _Traits::assign(__ptr, 1, __lhs);
4375 _Traits::copy(__ptr + 1, __rhs.data(), __rhs_sz);
4376 _Traits::assign(__ptr + 1 + __rhs_sz, 1, _CharT());
Howard Hinnantc51e1022010-05-11 19:42:16 +00004377 return __r;
4378}
4379
4380template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02004381inline _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00004382basic_string<_CharT, _Traits, _Allocator>
4383operator+(const basic_string<_CharT, _Traits, _Allocator>& __lhs, const _CharT* __rhs)
4384{
Nikolas Klauser38631bf2022-02-11 19:24:31 +01004385 using _String = basic_string<_CharT, _Traits, _Allocator>;
Nikolas Klauser38631bf2022-02-11 19:24:31 +01004386 typename _String::size_type __lhs_sz = __lhs.size();
4387 typename _String::size_type __rhs_sz = _Traits::length(__rhs);
Nikolas Klauser55dc8082022-04-09 16:19:45 +02004388 _String __r(__uninitialized_size_tag(),
4389 __lhs_sz + __rhs_sz,
4390 _String::__alloc_traits::select_on_container_copy_construction(__lhs.get_allocator()));
4391 auto __ptr = std::__to_address(__r.__get_pointer());
4392 _Traits::copy(__ptr, __lhs.data(), __lhs_sz);
4393 _Traits::copy(__ptr + __lhs_sz, __rhs, __rhs_sz);
4394 _Traits::assign(__ptr + __lhs_sz + __rhs_sz, 1, _CharT());
Howard Hinnantc51e1022010-05-11 19:42:16 +00004395 return __r;
4396}
4397
4398template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser80b3cf32022-04-27 10:11:44 +02004399_LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00004400basic_string<_CharT, _Traits, _Allocator>
4401operator+(const basic_string<_CharT, _Traits, _Allocator>& __lhs, _CharT __rhs)
4402{
Nikolas Klauser38631bf2022-02-11 19:24:31 +01004403 using _String = basic_string<_CharT, _Traits, _Allocator>;
Nikolas Klauser38631bf2022-02-11 19:24:31 +01004404 typename _String::size_type __lhs_sz = __lhs.size();
Nikolas Klauser55dc8082022-04-09 16:19:45 +02004405 _String __r(__uninitialized_size_tag(),
4406 __lhs_sz + 1,
4407 _String::__alloc_traits::select_on_container_copy_construction(__lhs.get_allocator()));
4408 auto __ptr = std::__to_address(__r.__get_pointer());
4409 _Traits::copy(__ptr, __lhs.data(), __lhs_sz);
4410 _Traits::assign(__ptr + __lhs_sz, 1, __rhs);
4411 _Traits::assign(__ptr + 1 + __lhs_sz, 1, _CharT());
Howard Hinnantc51e1022010-05-11 19:42:16 +00004412 return __r;
4413}
4414
Eric Fiselierfc92be82017-04-19 00:28:44 +00004415#ifndef _LIBCPP_CXX03_LANG
Howard Hinnantc51e1022010-05-11 19:42:16 +00004416
4417template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004418inline _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00004419basic_string<_CharT, _Traits, _Allocator>
4420operator+(basic_string<_CharT, _Traits, _Allocator>&& __lhs, const basic_string<_CharT, _Traits, _Allocator>& __rhs)
4421{
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004422 return std::move(__lhs.append(__rhs));
Howard Hinnantc51e1022010-05-11 19:42:16 +00004423}
4424
4425template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004426inline _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00004427basic_string<_CharT, _Traits, _Allocator>
4428operator+(const basic_string<_CharT, _Traits, _Allocator>& __lhs, basic_string<_CharT, _Traits, _Allocator>&& __rhs)
4429{
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004430 return std::move(__rhs.insert(0, __lhs));
Howard Hinnantc51e1022010-05-11 19:42:16 +00004431}
4432
4433template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004434inline _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00004435basic_string<_CharT, _Traits, _Allocator>
4436operator+(basic_string<_CharT, _Traits, _Allocator>&& __lhs, basic_string<_CharT, _Traits, _Allocator>&& __rhs)
4437{
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004438 return std::move(__lhs.append(__rhs));
Howard Hinnantc51e1022010-05-11 19:42:16 +00004439}
4440
4441template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004442inline _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00004443basic_string<_CharT, _Traits, _Allocator>
4444operator+(const _CharT* __lhs , basic_string<_CharT,_Traits,_Allocator>&& __rhs)
4445{
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004446 return std::move(__rhs.insert(0, __lhs));
Howard Hinnantc51e1022010-05-11 19:42:16 +00004447}
4448
4449template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004450inline _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00004451basic_string<_CharT, _Traits, _Allocator>
4452operator+(_CharT __lhs, basic_string<_CharT,_Traits,_Allocator>&& __rhs)
4453{
4454 __rhs.insert(__rhs.begin(), __lhs);
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004455 return std::move(__rhs);
Howard Hinnantc51e1022010-05-11 19:42:16 +00004456}
4457
4458template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004459inline _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00004460basic_string<_CharT, _Traits, _Allocator>
4461operator+(basic_string<_CharT, _Traits, _Allocator>&& __lhs, const _CharT* __rhs)
4462{
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004463 return std::move(__lhs.append(__rhs));
Howard Hinnantc51e1022010-05-11 19:42:16 +00004464}
4465
4466template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004467inline _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00004468basic_string<_CharT, _Traits, _Allocator>
4469operator+(basic_string<_CharT, _Traits, _Allocator>&& __lhs, _CharT __rhs)
4470{
4471 __lhs.push_back(__rhs);
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004472 return std::move(__lhs);
Howard Hinnantc51e1022010-05-11 19:42:16 +00004473}
4474
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04004475#endif // _LIBCPP_CXX03_LANG
Howard Hinnantc51e1022010-05-11 19:42:16 +00004476
4477// swap
4478
4479template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004480inline _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnantc51e1022010-05-11 19:42:16 +00004481void
Howard Hinnantaeb17d82011-05-29 19:57:12 +00004482swap(basic_string<_CharT, _Traits, _Allocator>& __lhs,
Howard Hinnant3e276872011-06-03 18:40:47 +00004483 basic_string<_CharT, _Traits, _Allocator>& __rhs)
4484 _NOEXCEPT_(_NOEXCEPT_(__lhs.swap(__rhs)))
Howard Hinnantc51e1022010-05-11 19:42:16 +00004485{
4486 __lhs.swap(__rhs);
4487}
4488
Bruce Mitchener170d8972020-11-24 12:53:53 -05004489_LIBCPP_FUNC_VIS int stoi (const string& __str, size_t* __idx = nullptr, int __base = 10);
4490_LIBCPP_FUNC_VIS long stol (const string& __str, size_t* __idx = nullptr, int __base = 10);
4491_LIBCPP_FUNC_VIS unsigned long stoul (const string& __str, size_t* __idx = nullptr, int __base = 10);
4492_LIBCPP_FUNC_VIS long long stoll (const string& __str, size_t* __idx = nullptr, int __base = 10);
4493_LIBCPP_FUNC_VIS unsigned long long stoull(const string& __str, size_t* __idx = nullptr, int __base = 10);
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +00004494
Bruce Mitchener170d8972020-11-24 12:53:53 -05004495_LIBCPP_FUNC_VIS float stof (const string& __str, size_t* __idx = nullptr);
4496_LIBCPP_FUNC_VIS double stod (const string& __str, size_t* __idx = nullptr);
4497_LIBCPP_FUNC_VIS long double stold(const string& __str, size_t* __idx = nullptr);
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +00004498
Howard Hinnanta37d3cf2013-08-12 18:38:34 +00004499_LIBCPP_FUNC_VIS string to_string(int __val);
4500_LIBCPP_FUNC_VIS string to_string(unsigned __val);
4501_LIBCPP_FUNC_VIS string to_string(long __val);
4502_LIBCPP_FUNC_VIS string to_string(unsigned long __val);
4503_LIBCPP_FUNC_VIS string to_string(long long __val);
4504_LIBCPP_FUNC_VIS string to_string(unsigned long long __val);
4505_LIBCPP_FUNC_VIS string to_string(float __val);
4506_LIBCPP_FUNC_VIS string to_string(double __val);
4507_LIBCPP_FUNC_VIS string to_string(long double __val);
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +00004508
Louis Dionne89258142021-08-23 15:32:36 -04004509#ifndef _LIBCPP_HAS_NO_WIDE_CHARACTERS
Bruce Mitchener170d8972020-11-24 12:53:53 -05004510_LIBCPP_FUNC_VIS int stoi (const wstring& __str, size_t* __idx = nullptr, int __base = 10);
4511_LIBCPP_FUNC_VIS long stol (const wstring& __str, size_t* __idx = nullptr, int __base = 10);
4512_LIBCPP_FUNC_VIS unsigned long stoul (const wstring& __str, size_t* __idx = nullptr, int __base = 10);
4513_LIBCPP_FUNC_VIS long long stoll (const wstring& __str, size_t* __idx = nullptr, int __base = 10);
4514_LIBCPP_FUNC_VIS unsigned long long stoull(const wstring& __str, size_t* __idx = nullptr, int __base = 10);
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +00004515
Bruce Mitchener170d8972020-11-24 12:53:53 -05004516_LIBCPP_FUNC_VIS float stof (const wstring& __str, size_t* __idx = nullptr);
4517_LIBCPP_FUNC_VIS double stod (const wstring& __str, size_t* __idx = nullptr);
4518_LIBCPP_FUNC_VIS long double stold(const wstring& __str, size_t* __idx = nullptr);
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +00004519
Howard Hinnanta37d3cf2013-08-12 18:38:34 +00004520_LIBCPP_FUNC_VIS wstring to_wstring(int __val);
4521_LIBCPP_FUNC_VIS wstring to_wstring(unsigned __val);
4522_LIBCPP_FUNC_VIS wstring to_wstring(long __val);
4523_LIBCPP_FUNC_VIS wstring to_wstring(unsigned long __val);
4524_LIBCPP_FUNC_VIS wstring to_wstring(long long __val);
4525_LIBCPP_FUNC_VIS wstring to_wstring(unsigned long long __val);
4526_LIBCPP_FUNC_VIS wstring to_wstring(float __val);
4527_LIBCPP_FUNC_VIS wstring to_wstring(double __val);
4528_LIBCPP_FUNC_VIS wstring to_wstring(long double __val);
Louis Dionne89258142021-08-23 15:32:36 -04004529#endif // _LIBCPP_HAS_NO_WIDE_CHARACTERS
Howard Hinnanta5f4f8e2010-06-02 18:20:39 +00004530
Howard Hinnantc51e1022010-05-11 19:42:16 +00004531template<class _CharT, class _Traits, class _Allocator>
Martin Storsjö88890c22021-02-22 01:13:13 +02004532_LIBCPP_TEMPLATE_DATA_VIS
Eric Fiselierc9fdaf12020-01-15 17:02:17 -05004533const typename basic_string<_CharT, _Traits, _Allocator>::size_type
4534 basic_string<_CharT, _Traits, _Allocator>::npos;
Howard Hinnantc51e1022010-05-11 19:42:16 +00004535
Marshall Clow851b9ec2019-05-20 21:56:51 +00004536template <class _CharT, class _Allocator>
4537struct _LIBCPP_TEMPLATE_VIS
4538 hash<basic_string<_CharT, char_traits<_CharT>, _Allocator> >
4539 : public unary_function<
4540 basic_string<_CharT, char_traits<_CharT>, _Allocator>, size_t>
Howard Hinnantc51e1022010-05-11 19:42:16 +00004541{
4542 size_t
Marshall Clow851b9ec2019-05-20 21:56:51 +00004543 operator()(const basic_string<_CharT, char_traits<_CharT>, _Allocator>& __val) const _NOEXCEPT
4544 { return __do_string_hash(__val.data(), __val.data() + __val.size()); }
Howard Hinnantc51e1022010-05-11 19:42:16 +00004545};
4546
Howard Hinnantc51e1022010-05-11 19:42:16 +00004547
Howard Hinnantdc095972011-07-18 15:51:59 +00004548template<class _CharT, class _Traits, class _Allocator>
4549basic_ostream<_CharT, _Traits>&
4550operator<<(basic_ostream<_CharT, _Traits>& __os,
4551 const basic_string<_CharT, _Traits, _Allocator>& __str);
4552
4553template<class _CharT, class _Traits, class _Allocator>
4554basic_istream<_CharT, _Traits>&
4555operator>>(basic_istream<_CharT, _Traits>& __is,
4556 basic_string<_CharT, _Traits, _Allocator>& __str);
4557
4558template<class _CharT, class _Traits, class _Allocator>
4559basic_istream<_CharT, _Traits>&
4560getline(basic_istream<_CharT, _Traits>& __is,
4561 basic_string<_CharT, _Traits, _Allocator>& __str, _CharT __dlm);
4562
4563template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004564inline _LIBCPP_HIDE_FROM_ABI
Howard Hinnantdc095972011-07-18 15:51:59 +00004565basic_istream<_CharT, _Traits>&
4566getline(basic_istream<_CharT, _Traits>& __is,
4567 basic_string<_CharT, _Traits, _Allocator>& __str);
4568
Howard Hinnantdc095972011-07-18 15:51:59 +00004569template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004570inline _LIBCPP_HIDE_FROM_ABI
Howard Hinnantdc095972011-07-18 15:51:59 +00004571basic_istream<_CharT, _Traits>&
4572getline(basic_istream<_CharT, _Traits>&& __is,
4573 basic_string<_CharT, _Traits, _Allocator>& __str, _CharT __dlm);
4574
4575template<class _CharT, class _Traits, class _Allocator>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004576inline _LIBCPP_HIDE_FROM_ABI
Howard Hinnantdc095972011-07-18 15:51:59 +00004577basic_istream<_CharT, _Traits>&
4578getline(basic_istream<_CharT, _Traits>&& __is,
4579 basic_string<_CharT, _Traits, _Allocator>& __str);
4580
Marshall Clow29b53f22018-12-14 18:49:35 +00004581#if _LIBCPP_STD_VER > 17
Marek Kurdeja98b1412020-05-02 13:58:03 +02004582template <class _CharT, class _Traits, class _Allocator, class _Up>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004583inline _LIBCPP_HIDE_FROM_ABI
Marek Kurdeja98b1412020-05-02 13:58:03 +02004584 typename basic_string<_CharT, _Traits, _Allocator>::size_type
4585 erase(basic_string<_CharT, _Traits, _Allocator>& __str, const _Up& __v) {
4586 auto __old_size = __str.size();
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004587 __str.erase(std::remove(__str.begin(), __str.end(), __v), __str.end());
Marek Kurdeja98b1412020-05-02 13:58:03 +02004588 return __old_size - __str.size();
4589}
Marshall Clow29b53f22018-12-14 18:49:35 +00004590
Marek Kurdeja98b1412020-05-02 13:58:03 +02004591template <class _CharT, class _Traits, class _Allocator, class _Predicate>
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004592inline _LIBCPP_HIDE_FROM_ABI
Marek Kurdeja98b1412020-05-02 13:58:03 +02004593 typename basic_string<_CharT, _Traits, _Allocator>::size_type
4594 erase_if(basic_string<_CharT, _Traits, _Allocator>& __str,
4595 _Predicate __pred) {
4596 auto __old_size = __str.size();
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004597 __str.erase(std::remove_if(__str.begin(), __str.end(), __pred),
Marek Kurdeja98b1412020-05-02 13:58:03 +02004598 __str.end());
4599 return __old_size - __str.size();
4600}
Marshall Clow29b53f22018-12-14 18:49:35 +00004601#endif
4602
Louis Dionne510450b2022-04-01 16:38:30 -04004603#ifdef _LIBCPP_ENABLE_DEBUG_MODE
Howard Hinnant8ea98242013-08-23 17:37:05 +00004604
4605template<class _CharT, class _Traits, class _Allocator>
4606bool
4607basic_string<_CharT, _Traits, _Allocator>::__dereferenceable(const const_iterator* __i) const
4608{
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004609 return data() <= std::__to_address(__i->base()) &&
4610 std::__to_address(__i->base()) < data() + size();
Howard Hinnant8ea98242013-08-23 17:37:05 +00004611}
4612
4613template<class _CharT, class _Traits, class _Allocator>
4614bool
4615basic_string<_CharT, _Traits, _Allocator>::__decrementable(const const_iterator* __i) const
4616{
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004617 return data() < std::__to_address(__i->base()) &&
4618 std::__to_address(__i->base()) <= data() + size();
Howard Hinnant8ea98242013-08-23 17:37:05 +00004619}
4620
4621template<class _CharT, class _Traits, class _Allocator>
4622bool
4623basic_string<_CharT, _Traits, _Allocator>::__addable(const const_iterator* __i, ptrdiff_t __n) const
4624{
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004625 const value_type* __p = std::__to_address(__i->base()) + __n;
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01004626 return data() <= __p && __p <= data() + size();
Howard Hinnant8ea98242013-08-23 17:37:05 +00004627}
4628
4629template<class _CharT, class _Traits, class _Allocator>
4630bool
4631basic_string<_CharT, _Traits, _Allocator>::__subscriptable(const const_iterator* __i, ptrdiff_t __n) const
4632{
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004633 const value_type* __p = std::__to_address(__i->base()) + __n;
Nikolas Klauser00ba7f82021-12-28 13:09:40 +01004634 return data() <= __p && __p < data() + size();
Howard Hinnant8ea98242013-08-23 17:37:05 +00004635}
4636
Louis Dionne510450b2022-04-01 16:38:30 -04004637#endif // _LIBCPP_ENABLE_DEBUG_MODE
Howard Hinnant8ea98242013-08-23 17:37:05 +00004638
Louis Dionne173f29e2019-05-29 16:01:36 +00004639#if _LIBCPP_STD_VER > 11
Marshall Clowcba751f2013-07-23 17:05:24 +00004640// Literal suffixes for basic_string [basic.string.literals]
Marshall Clowac868372013-10-05 21:18:32 +00004641inline namespace literals
Marshall Clowcba751f2013-07-23 17:05:24 +00004642{
4643 inline namespace string_literals
4644 {
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004645 inline _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnant5c167562013-08-07 19:39:48 +00004646 basic_string<char> operator "" s( const char *__str, size_t __len )
4647 {
4648 return basic_string<char> (__str, __len);
4649 }
Marshall Clowcba751f2013-07-23 17:05:24 +00004650
Louis Dionne89258142021-08-23 15:32:36 -04004651#ifndef _LIBCPP_HAS_NO_WIDE_CHARACTERS
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004652 inline _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnant5c167562013-08-07 19:39:48 +00004653 basic_string<wchar_t> operator "" s( const wchar_t *__str, size_t __len )
4654 {
4655 return basic_string<wchar_t> (__str, __len);
4656 }
Louis Dionne89258142021-08-23 15:32:36 -04004657#endif
Marshall Clowcba751f2013-07-23 17:05:24 +00004658
Arthur O'Dwyerafa5d5f2021-04-18 21:47:08 -04004659#ifndef _LIBCPP_HAS_NO_CHAR8_T
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004660 inline _LIBCPP_HIDE_FROM_ABI constexpr
Marshall Clow8732fed2018-12-11 04:35:44 +00004661 basic_string<char8_t> operator "" s(const char8_t *__str, size_t __len) _NOEXCEPT
4662 {
4663 return basic_string<char8_t> (__str, __len);
4664 }
4665#endif
4666
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004667 inline _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnant5c167562013-08-07 19:39:48 +00004668 basic_string<char16_t> operator "" s( const char16_t *__str, size_t __len )
4669 {
4670 return basic_string<char16_t> (__str, __len);
4671 }
Marshall Clowcba751f2013-07-23 17:05:24 +00004672
Nikolas Klauser1d5108d2022-04-29 11:17:58 +02004673 inline _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_AFTER_CXX17
Howard Hinnant5c167562013-08-07 19:39:48 +00004674 basic_string<char32_t> operator "" s( const char32_t *__str, size_t __len )
4675 {
4676 return basic_string<char32_t> (__str, __len);
4677 }
Nikolas Klauserd26407a2021-12-02 14:12:51 +01004678 } // namespace string_literals
4679} // namespace literals
Mark de Weverdf3e0d42021-09-26 15:47:42 +02004680
4681#if _LIBCPP_STD_VER > 17
4682template <>
4683inline constexpr bool __format::__enable_insertable<std::basic_string<char>> = true;
4684#ifndef _LIBCPP_HAS_NO_WIDE_CHARACTERS
4685template <>
4686inline constexpr bool __format::__enable_insertable<std::basic_string<wchar_t>> = true;
4687#endif
4688#endif
4689
Marshall Clowcba751f2013-07-23 17:05:24 +00004690#endif
4691
Howard Hinnantc51e1022010-05-11 19:42:16 +00004692_LIBCPP_END_NAMESPACE_STD
4693
Eric Fiselierf4433a32017-05-31 22:07:49 +00004694_LIBCPP_POP_MACROS
4695
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04004696#endif // _LIBCPP_STRING