std::basic_string::operator=

From cppreference.com
< cpp‎ | string‎ | basic string
 
 
 
std::basic_string
 
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)

Contents

[edit] 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

[edit] Return value

*this

[edit] 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

[edit] 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)

[edit] Example

[edit] See also

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