std::basic_string<CharT,Traits,Allocator>::replace_with_range
From cppreference.com
< cpp | string | basic string
C++
Feature test macros (C++20)
Concepts library (C++20)
Metaprogramming library (C++11)
Ranges library (C++20)
Filesystem library (C++17)
Concurrency support library (C++11)
Execution control library (C++26)
std::basic_string
Literals Helper classes Deduction guides (C++17)
(C++23)
(DR*)
(DR*)
(C++23)
(DR*)
(C++23)
basic_string::replace_with_range
(C++23)
(C++20)
(C++20)
(C++23)
(C++20)(C++20)
(until C++20)(until C++20)(until C++20)(until C++20)(until C++20)(C++20)
(C++11)(C++11)(C++11)
(C++11)(C++11)
(C++14)
(C++11)
template< container-compatible-range <CharT> R >
(since C++23)
constexpr std::basic_string & replace_with_range( const_iterator first,
const_iterator last,
Replaces the characters in the range [first, last) with the characters from the range rg.
Equivalent to
return replace(first, last, std::basic_string ( std::from_range, std::forward <R>(rg), get_allocator()) );
[edit] Parameters
first, last
-
range of characters that is going to be replaced
rg
-
a container compatible range
[edit] Return value
*this
[edit] Complexity
Linear in size of rg.
[edit] Exceptions
If the operation would cause size() to exceed max_size() , throws std::length_error .
If an exception is thrown for any reason, this function has no effect (strong exception safety guarantee).
[edit] Notes
| Feature-test macro | Value | Std | Feature |
|---|---|---|---|
__cpp_lib_containers_ranges |
202202L |
(C++23) | member functions that accept container compatible range |
[edit] Example
Run this code
#include <algorithm> #include <cassert> #include <forward_list> #include <iterator> #include <string> int main() { using namespace std::literals; auto s{"Today is today!"s}; constexpr auto today{"today"sv}; constexpr auto tomorrow{"tomorrow's yesterday"sv}; std::forward_list <char> rg; std::ranges::reverse_copy (tomorrow, std::front_inserter (rg)); const auto pos{s.rfind(today)}; assert (pos != s.npos); const auto first{std::next (s.begin(), pos)}; const auto last{std::next (first, today.length())}; #ifdef __cpp_lib_containers_ranges s.replace_range(first, last, rg); #else s.replace(first, last, rg.cbegin(), rg.cend()); #endif assert ("Today is tomorrow's yesterday!" == s); }