Namespaces
Variants
Views
Actions

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

From cppreference.com
< cpp‎ | string‎ | basic string
m (fmt)
m (→‎Example: ~naming.)
 
(5 intermediate revisions by one user not shown)
Line 1: Line 1:
 
{{cpp/string/basic_string/title|append_range}}
 
{{cpp/string/basic_string/title|append_range}}
 
{{cpp/string/basic_string/navbar}}
 
{{cpp/string/basic_string/navbar}}
−
{{dcl begin}}
+
{{|since=c++23|1=
−
{{dcl|num=1|since=c++23|1=
+
 
template< container-compatible-range<CharT> R >
 
template< container-compatible-range<CharT> R >
−
constexpr std::basic_string& append_range(R&& rg);
+
constexpr std::basic_string& append_range( R&& rg );
 
}}
 
}}
−
{{dcl end}}
 
  
 
Appends all characters from the range {{c|rg}}.
 
Appends all characters from the range {{c|rg}}.
Line 17: Line 15:
 
===Parameters===
 
===Parameters===
 
{{par begin}}
 
{{par begin}}
−
{{par|rg|a [[cpp/ranges/to|''container-compatible-range'']]}}
+
{{par|rg|a cpp/ranges/tocontainer compatible range}}
 
{{par end}}
 
{{par end}}
  
Line 27: Line 25:
  
 
===Exceptions===
 
===Exceptions===
−
Throws {{lc|std::length_error}} if the resultant string size would exceed {{rlpf|max_size}}.
+
{{string}}
  
 
{{cpp/strong exception safety guarantee}}
 
{{cpp/strong exception safety guarantee}}
 +
 +
 +
  
 
===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"