std::basic_string<CharT,Traits,Allocator>:: assign_range
| Classes | ||||
|
(C++17)
|
||||
|
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
template
<
container-compatible-range
<
CharT
>
R
>
constexpr std:: basic_string & assign_range ( R && rg ) ; |
(начиная с C++23) | |
Заменяет содержимое строки значениями из диапазона rg .
Эквивалентно
return assign( std::basic_string( std::from_range, std::forward<R>(rg), get_allocator()) );
` и `` оставлен без изменений, как и требовалось. HTML-разметка и атрибуты также сохранены в оригинальном виде.
Содержание |
Параметры
| rg | - | a container compatible range |
Возвращаемое значение
* this
Сложность
Линейный по размеру rg .
Исключения
Если операция приведёт к тому, что
size()
превысит
max_size()
, выбрасывается
std::length_error
.
Если по какой-либо причине возникает исключение, эта функция не оказывает никакого эффекта ( гарантия строгой безопасности исключений ).
Примечания
| Feature-test macro | Value | Std | Feature |
|---|---|---|---|
__cpp_lib_containers_ranges
|
202202L
|
(C++23) | функции-члены, принимающие container compatible range |
Пример
#include <cassert> #include <string> int main() { const auto source = {'s', 'o', 'u', 'r', 'c', 'e'}; std::string destination{"destination"}; #ifdef __cpp_lib_containers_ranges destination.assign_range(source); #else destination.assign(source.begin(), source.end()); #endif assert(destination == "source"); }
Смотрите также
|
присваивает символы строке
(публичная функция-член) |
|
|
присваивает значения строке
(публичная функция-член) |
|
создаёт
basic_string
(публичная функция-член) |