std::basic_string<CharT,Traits,Allocator>::append_range — cppreference.com

Материал из cppreference.com

`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()));

Параметры

Возвращаемое значение

*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");
}

Смотрите также

Категории: