std::basic_string::operator=
From cppreference.com
< cpp | string | basic string
| basic_string& operator=( const basic_string& str );
|
(1) | |
| basic_string& operator=( basic_string&& str ) noexcept;
|
(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
If an exception is thrown for any reason, this function has no effect (strong exception guarantee). (since C++11)
If the operation would result in size() > max_size(), throws std::length_error.
[edit] Example
| This section is incomplete Reason: no example |
[edit] See also
constructs a basic_string (public member function) |
|
| assign characters to a string (public member function) |