std::basic_string<CharT,Traits,Allocator>::append_range - cppreference.com (original) (raw)

Appends all characters from the range rg.

Equivalent to

Contents

• 1 Parameters
• 2 Return value
• 3 Complexity
• 4 Exceptions
• 5 Notes
• 6 Example
• 7 See also

[edit] Parameters

[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

[edit] Example

#include #include   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] | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |