std::basic_string<CharT,Traits,Allocator>::append_range
Материал из cppreference.com
< cpp | string | basic string
| template< container-compatible-range<CharT> R > constexpr std::basic_string& append_range( R&& rg ); |
(начиная с C++23) | |
Добавляет все символы из диапазона rg.
Эквивалентно
return append(std::basic_string( std::from_range, std::forward<R>(rg), get_allocator()));
Содержание |
[править] Параметры
| rg | — | no section name |
[править] Возвращаемое значение
*this
[править] Сложность
Линейная по размеру rg.
[править] Исключения
Если операция приведёт к size() > max_size(), генерирует std::length_error.
Если по какой-либо причине генерируется исключение, эта функция не имеет эффекта (строгая гарантия безопасности исключений).
[править] Примечание
| Макрос Тестирования функциональности | Значение | Стандарт | Функциональность |
|---|---|---|---|
__cpp_lib_containers_ranges |
202202L | (C++23) | функции-элементы, которые принимают no section name |
[править] Пример
Запустить этот код
#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"); }
[править] Смотрите также
| добавляет символы в конец (public функция-элемент) |
