Пространства имён
Варианты
Действия

std::basic_string<CharT,Traits,Allocator>::assign_range

Материал из cppreference.com
< cpp‎ | string‎ | basic string
 
C++
Поддержка компилятором
Автономные и размещённые реализации
Язык
Стандартная библиотека
Заголовки стандартной библиотеки
Требования к именованию
Макросы тестирования функциональности (C++20)
Поддержка языка
Библиотека концептов (C++20)
Библиотека метапрограммирования (C++11)
Библиотека диагностики
Библиотека общих утилит
Библиотека строк
Библиотека контейнеров
Библиотека итераторов
Библиотека диапазонов (C++20)
Библиотека алгоритмов
Библиотека численных данных
Библиотека ввода/вывода
Библиотека локализаций
Регулярные выражения (C++11)
Атомарные операции (C++11)
Библиотека поддержки конкуренции (C++11)
Библиотека файловой системы (C++17)
Технические спецификации
Указатель символов
Внешние библиотеки
 
Строки
 
std::basic_string
Функции-элементы
basic_string::assign_range
(C++23)
Доступ к элементам
(DR*)
(DR*)
(C++17)
Итераторы
(DR*)
(DR*)
(DR*)
(DR*)
Ёмкость
(DR*)
Операции
(C++23)
(DR*)
(C++23)
(C++23)
(C++23)  
Поиск
(C++20)  
(C++20)
(C++23)
Константы
Правила вывода (C++17)
Функции, не являющиеся элементами
(C++14)
(C++20)(C++20)
Ввод/Вывод
Сравнение
(до C++20)(до C++20)(до C++20)(до C++20)(до C++20)(C++20)
Числовые преобразования
(C++11)(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)(C++11)
(C++11)
(C++11)
Вспомогательные классы
(C++11)  (C++11)(C++11)(C++11)(C++20)
(C++17)(C++17)(C++17)(C++17)(C++20)
 
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())
);

Содержание

[править] Параметры

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

[править] Смотрите также

 присваивает символы строке
(public функция-элемент) [править]
присваивает значения строке
(public функция-элемент) [править]
создаёт basic_string
(public функция-элемент) [править]
Источник — «https://ru.cppreference.com/mwiki/index.php?title=cpp/string/basic_string/assign_range&oldid=63997»