Namespaces
Variants
Views
Actions

Difference between revisions of "cpp/string/basic string/append range"

From cppreference.com
< cpp‎ | string‎ | basic string
m (##)
m (→‎Example: ~naming.)
 
(One intermediate revision by one user not shown)
Line 33: Line 33:
  
 
===Example===
 
===Example===
−
{{example}}
+
{{example
 +
 +
 +
 +
 
 +
 +
 +
 +
 +
 
 +
 +
 +
 +
 +
 +
 
 +
 +
 +
}}
  
 
===See also===
 
===See also===

Latest revision as of 15:47, 28 October 2023

 
C++
 
Strings library
 
std::basic_string
 
template< container-compatible-range<CharT> R >
constexpr std::basic_string& append_range( R&& rg );
 (since C++23)

Appends all characters from the range rg.

Equivalent to 

return append(std::basic_string( std::from_range, std​::​forward<R>(rg), get_allocator()));

Contents

[edit] Parameters

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 <cassert>
#include <string>
 
int main()
{
    std::string head{"long long"};
    const auto tail = {' ', 'i', 'n', 't'};
 
#ifdef __cpp_lib_containers_ranges
    head.append_range(tail);
#else
    head.append(tail.begin(), tail.end());
#endif
 
    assert(head == "long long int");
}

[edit] See also

 appends characters to the end
(public member function) [edit]
Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/string/basic_string/append_range&oldid=161647"