std::basic_string::operator=

 

C++

Language

Standard library headers

Concepts

Utilities library

Strings library

Containers library

Algorithms library

Iterators library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

 

Strings library

Null-terminated strings

Byte strings

Multibyte strings

Wide strings

Classes

basic_string

char_traits

 

std::basic_string

Member functions basic_string::basic_string basic_string::operator= basic_string::assign basic_string::get_allocator Element access basic_string::at basic_string::operator[] basic_string::front (C++11) basic_string::back (C++11) basic_string::data basic_string::c_str Iterators basic_string::beginbasic_string::cbegin (C++11) basic_string::endbasic_string::cend (C++11) basic_string::rbeginbasic_string::crbegin (C++11) basic_string::rendbasic_string::crend (C++11) Capacity basic_string::empty basic_string::sizebasic_string::length basic_string::max_size basic_string::reserve basic_string::capacity basic_string::shrink_to_fit (C++11)

Operations basic_string::clear basic_string::insert basic_string::erase basic_string::push_back basic_string::pop_back (C++11) basic_string::append basic_string::operator+= basic_string::compare basic_string::replace basic_string::substr basic_string::copy basic_string::resize basic_string::swap Search 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 Constants basic_string::npos

Non-member functions operator+ operator==operator!=operator<operator>operator<=operator>= swap(std::basic_string) operator<<operator>> getline 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) Helper classes hash<std::string>hash<std::wstring>hash<std::u32string>hash<std::u16string> (C++11)

 

basic_string& operator=( const basic_string& str );	(1)
basic_string& operator=( basic_string&& str );	(2)	(since C++11)
basic_string& operator=( const CharT* s );	(3)
basic_string& operator=( CharT ch );	(4)
basic_string& operator=( std::initializer_list<CharT> ilist );	(5)	(since C++11)

Replaces the contents of the string.

1) Replaces the contents with a copy of str. If *this and str are the same object, this function has no effect.

2) Replaces the contents with those of str using move semantics. Leaves str in valid, but inspecified state. The behavior is undefined if *this and str are the same object.

3) Replaces the contents with those of null-terminated character string pointed to by s as if by *this = basic_string(s), which involves a call to Traits::length(s).

4) Replaces the contents with character ch as if by *this = basic_string(1,c)

5) Replaces the contents with those of the initializer list ilist as if by *this = basic_string(ilist)

Parameters

ch	-	value to initialize characters of the string with
str	-	string to be used as source to initialize the string with
s	-	pointer to a null-terminated character string to use as source to initialize the string with
init	-	initializer list to initialize the string with

Return value

*this

Complexity

1) linear in size of str

2) constant. If alloc is given and alloc != other.get_allocator(), then linear.

3) linear in size of s

4) constant.

5) linear in size of init

Exceptions

2) noexcept specification:   noexcept	(since C++11) (until C++17)
2) noexcept specification:   noexcept(std::allocator_traits<Allocator>::propagate_on_container_move_assignment::value || std::allocator_traits<Allocator>::is_always_equal::value)	(since C++17)

If the operation would result in size() > max_size(), throws std::length_error.

If an exception is thrown for any reason, this function has no effect (strong exception guarantee).

(since C++11)

See also

(constructor)	constructs a basic_string (public member function)
assign	assign characters to a string (public member function)