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

	(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(/* see below */);		(с C++11) (до C++20)
constexpr basic_string& assign( basic_string&& str ) noexcept(/* see below */);		(с 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	-	список инициализации для инициализации символов строки
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.

Исключения

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::string const c("Exemplary");
    // assign(const basic_string& str)
    s.assign(c);
    std::cout << c << " == " << s << '\n'; // "Exemplary == Exemplary"
 
    // assign(const basic_string& str, size_type pos, size_type count)
    s.assign(c, 0, c.length() - 1);
    std::cout << s << '\n'; // "Exemplar";
 
    // assign(basic_string&& str)
    s.assign(std::string("C++ by ") + "example");
    std::cout << s << '\n'; // "C++ by example"
 
    // assign(const CharT* s, size_type count)
    s.assign("C-style string", 7);
    std::cout << s << '\n'; // "C-style"
 
    // assign(const CharT* s)
    s.assign("C-style\0string");
    std::cout << s << '\n'; // "C-style"
 
    char mutable_c_str[] = "C-style string";
    // assign(InputIt first, InputIt last)
    s.assign(std::begin(mutable_c_str), std::end(mutable_c_str) - 1);
    std::cout << s << '\n'; // "C-style string"
 
    // assign(std::initializer_list<CharT> ilist)
    s.assign({'C', '-', 's', 't', 'y', 'l', 'e'});
    std::cout << s << '\n'; // "C-style"
}

Вывод:

====
Exemplary == Exemplary
Exemplar
C++ by example
C-style
C-style
C-style string
C-style

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

END_OF_DOCUMENT_MARKER

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

См. также

assign_range (C++23)	назначение диапазона символов строке (общедоступный член-функция)
(конструктор)	строит `basic_string` (общедоступный член-функция)
operator=	присваивает значения строке (общедоступный член-функция)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/string/basic_string/assign