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

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов(C++20)

Библиотека метапрограммирования(C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов(C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения(C++11)

Атомарные операции(C++11)

Библиотека поддержки конкуренции(C++11)

Библиотека файловой системы(C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Строки

Строки с завершающим нулём

Однобайтовые строки

Многобайтовые строки

Широкие строки

Классы

basic_string

basic_string_view (C++17)

char_traits

 

std::basic_string

Функции-элементы basic_string::basic_string basic_string::~basic_string basic_string::operator= basic_string::assign basic_string::assign_range (C++23) basic_string::get_allocator Доступ к элементам basic_string::at basic_string::operator[] basic_string::front (DR*) basic_string::back (DR*) basic_string::data basic_string::c_str basic_string::operator  basic_string_view (C++17) Итераторы basic_string::beginbasic_string::cbegin (DR*) basic_string::endbasic_string::cend (DR*) basic_string::rbeginbasic_string::crbegin (DR*) basic_string::rendbasic_string::crend (DR*) Ёмкость basic_string::empty basic_string::sizebasic_string::length basic_string::max_size basic_string::reserve basic_string::capacity basic_string::shrink_to_fit (DR*) Операции basic_string::clear basic_string::insert basic_string::insert_range (C++23) basic_string::erase basic_string::push_back basic_string::pop_back (DR*) basic_string::append basic_string::append_range (C++23) basic_string::operator+= basic_string::compare basic_string::replace basic_string::replace_with_range (C++23) basic_string::substr basic_string::copy basic_string::resize basic_string::resize_and_overwrite (C++23)   basic_string::swap

Поиск basic_string::starts_with (C++20)   basic_string::ends_with (C++20) basic_string::contains (C++23) basic_string::find basic_string::rfind basic_string::find_first_of basic_string::find_first_not_of basic_string::find_last_of basic_string::find_last_not_of Константы basic_string::npos Правила вывода(C++17) Функции, не являющиеся элементами operator+ swap(std::basic_string) operator""s (C++14) erase(std::basic_string)erase_if(std::basic_string) (C++20)(C++20) Ввод/Вывод operator<<operator>> getline Сравнение operator==operator!=operator<operator>operator<=operator>=operator<=> (до C++20)(до C++20)(до C++20)(до C++20)(до C++20)(C++20) Числовые преобразования stoistolstoll (C++11)(C++11)(C++11) stoulstoull (C++11)(C++11) stofstodstold (C++11)(C++11)(C++11) to_string (C++11) to_wstring (C++11) Вспомогательные классы hash<std::string>hash<std::wstring>hash<std::u32string>hash<std::u16string>hash<std::u8string> (C++11)  (C++11)(C++11)(C++11)(C++20) hash<std::pmr::string>hash<std::pmr::wstring>hash<std::pmr::u32string>hash<std::pmr::u16string>hash<std::pmr::u8string> (C++17)(C++17)(C++17)(C++17)(C++20)

 

(1)

basic_string& assign( size_type count, CharT ch );

(до C++20)

constexpr basic_string& assign( size_type count, CharT ch );

(начиная с C++20)

(2)

basic_string& assign(const basic_string& str );

(до C++20)

constexpr basic_string& assign(const basic_string& str );

(начиная с C++20)

(3)

basic_string& assign(const basic_string& str,                       size_type pos, size_type count );

(до C++14)

basic_string& assign(const basic_string& str,                       size_type pos, size_type count = npos);

(начиная с C++14) (до C++20)

constexpr basic_string& assign(const basic_string& str,                                 size_type pos, size_type count = npos);

(начиная с C++20)

(4)

basic_string& assign( basic_string&& str )noexcept(/* смотрите ниже */);

(начиная с C++11) (до C++20)

constexpr basic_string& assign( basic_string&& str )     noexcept(/* смотрите ниже */);

(начиная с C++20)

(5)

basic_string& assign(const CharT* s, size_type count );

(до C++20)

constexpr basic_string& assign(const CharT* s, size_type count );

(начиная с C++20)

(6)

basic_string& assign(const CharT* s );

(до C++20)

constexpr basic_string& assign(const CharT* s );

(начиная с C++20)

(7)

template<class InputIt > basic_string& assign( InputIt first, InputIt last );

(до C++20)

template<class InputIt > constexpr basic_string& assign( InputIt first, InputIt last );

(начиная с C++20)

(8)

basic_string& assign(std::initializer_list<CharT> ilist );

(начиная с C++11) (до C++20)

constexpr basic_string& assign(std::initializer_list<CharT> ilist );

(начиная с C++20)

(9)

template<class StringViewLike > basic_string& assign(const StringViewLike& t );

(начиная с C++17) (до C++20)

template<class StringViewLike > constexpr basic_string& assign(const StringViewLike& t );

(начиная с C++20)

(10)

template<class StringViewLike > basic_string& assign(const StringViewLike& t,                       size_type pos, size_type count = npos);

(начиная с C++17) (до C++20)

template<class StringViewLike > constexpr basic_string& assign(const StringViewLike& t,                                 size_type pos, size_type count = npos);

(начиная с C++20)

Заменяет содержимое строки.

1) Заменяет содержимое count копиями символа ch.

2) Заменяет содержимое копией str. Эквивалентно *this = str;. В частности, может иметь место распространение аллокатора.(начиная с C++11)

3) Заменяет содержимое подстрокой [pos, pos + count) из str. Если запрошенная подстрока выходит за конец строки или если count == npos, результирующей подстрокой будет [pos, str.size()). Если pos > str.size(), генерируется std::out_of_range.

4) Заменяет содержимое на содержимое str, используя семантику перемещения. Эквивалентно *this = std::move(str). В частности, может иметь место распространение аллокатора.

5) Заменяет содержимое копиями символов в диапазоне [s, s + count). Этот диапазон может содержать нулевые символы.

6) Заменяет содержимое строкой символов с нулевым завершением, на которую указывает s. Длина строки определяется по первому нулевому символу с помощью Traits::length(s).

7) Заменяет содержимое копиями символов в диапазоне [first, last). Эта перегрузка не участвует в разрешении перегрузки, если InputIt не соответствует LegacyInputIterator.(начиная с C++11)

8) Заменяет содержимое на содержимое списка инициализаторов ilist.

9) Неявно преобразует t в строковое представление sv, как если бы с помощью std::basic_string_view<CharT, Traits> sv = t;, затем заменяет содержимое на содержимое sv, как будто с помощью assign(sv.data(), sv.size()).

Эта перегрузка участвует в разрешении перегрузки, только если std::is_convertible_v<const StringViewLike&,
                      std::basic_string_view<CharT, Traits>> равно true и std::is_convertible_v<const StringViewLike&, const CharT*> равно false.

10) Неявно преобразует t в строковое представление sv, как если бы с помощью std::basic_string_view<CharT, Traits> sv = t;, затем заменяет содержимое символами из подпредставления [pos, pos + count) из sv. Если запрошенное подпредставление продолжается после конца sv или если count == npos, результирующее подпредставление будет [pos, sv.size()). Если pos > sv.size(), генерируется std::out_of_range.

Эта перегрузка участвует в разрешении перегрузки, только если std::is_convertible_v<const StringViewLike&,
                      std::basic_string_view<CharT, Traits>> равно true и std::is_convertible_v<const StringViewLike&, const CharT*> равно false.

Параметры

count	—	размер строки результата
pos	—	индекс первого символа, который нужно принять
ch	—	значение для инициализации символов строки
first, last	—	диапазон для копирования символов
str	—	строка, которая будет использоваться в качестве источника для инициализации символов
s	—	указатель на строку символов, которая будет использоваться в качестве источника для инициализации строки
ilist	—	std::initializer_list для инициализации символов строки
t	—	объект (конвертируемый в std::basic_string_view) для инициализации символов строки
Требования к типам
- InputIt должен соответствовать требованиям LegacyInputIterator.

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

*this

Сложность

1) Линейная по count.

2) Линейная по размеру str.

3) Линейная по count.

4) Константная. Если задан alloc и alloc != other.get_allocator(), то линейная.

5) Линейная по count.

6) Линейная по размеру s.

7) Линейная по расстоянию между first и last.

8) Линейная по размеру ilist.

9) Линейная по размеру t.

Исключения

4)

спецификация noexcept:  

noexcept(std::allocator_traits<Allocator>::

             propagate_on_container_move_assignment::value||

         std::allocator_traits<Allocator>::is_always_equal::value)

Если операция приведёт к size()> max_size(), генерирует std::length_error.

Если по какой-либо причине генерируется исключение, эта функция не имеет эффекта (строгая гарантия безопасности исключений).

Пример

Запустить этот код

#include <iostream>#include <iterator>#include <string>   int main(){std::string s;// assign(size_type count, CharT ch) s.assign(4, '=');std::cout<< s <<'\n';// "===="   std::stringconst c("Образец");// assign(const basic_string& str) s.assign(c);std::cout<< c <<" == "<< s <<'\n';// "Образец == Образец"   // assign(const basic_string& str, size_type pos, size_type count) s.assign(c, 0, c.length()-1);std::cout<< s <<'\n';// "Образе";   // assign(basic_string&& str) s.assign(std::string("С++ на ")+"примере");std::cout<< s <<'\n';// "С++ на примере"   // assign(const CharT* s, size_type count) s.assign("строка в стиле C", 7);std::cout<< s <<'\n';// "строка "   // assign(const CharT* s) s.assign("строка\0в стиле С");std::cout<< s <<'\n';// "строка"   char mutable_c_str[]="строка в стиле С";// assign(InputIt first, InputIt last) s.assign(std::begin(mutable_c_str), std::end(mutable_c_str)-1);std::cout<< s <<'\n';// "строка в стиле С"   // assign(std::initializer_list<CharT> ilist) s.assign({'C', '-', 's', 't', 'y', 'l', 'e'});std::cout<< s <<'\n';// "C-style"}

Вывод:

==== Образец == Образец Образе С++ на примере строка строка строка в стиле С C-style

Отчёты о дефектах

Следующие изменения поведения были применены с обратной силой к ранее опубликованным стандартам C++:

Номер	Применён	Поведение в стандарте	Корректное поведение
LWG 847	C++98	не было гарантии безопасности исключений	добавлена надёжная гарантия безопасности исключений
LWG 2063	C++11	в ненормативном примечании указано, что swap является допустимой реализацией присваивания перемещением	исправлено требование присваивания перемещением
LWG 2579	C++11	assign(const basic_string&) не распространяла аллокаторы	сделано для распространения аллокаторов, если это необходимо
LWG 2946	C++17	перегрузка (9) в некоторых случаях вызывала двусмысленность	исключено, сделав его шаблоном

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

assign_range (C++23)	присваивает диапазон символов строке (public функция-элемент)
(конструктор)	создаёт basic_string (public функция-элемент)
operator=	присваивает значения строке (public функция-элемент)