Namespaces
Variants

std::basic_string<CharT,Traits,Allocator>:: operator=

From cppreference.net
C++
Strings library
std::basic_string
basic_string & operator = ( const basic_string & str ) ;
(1) (C++20以降 constexpr)
basic_string & operator = ( basic_string && str )
noexcept ( /* 下記参照 */ ) ;
(2) (C++11以降)
(C++20以降 constexpr)
basic_string & operator = ( const CharT * s ) ;
(3) (C++20以降 constexpr)
basic_string & operator = ( CharT ch ) ;
(4) (C++20以降 constexpr)
basic_string & operator = ( std:: initializer_list < CharT > ilist ) ;
(5) (C++11以降)
(C++20以降 constexpr)
template < class StringViewLike >
basic_string & operator = ( const StringViewLike & t ) ;
(6) (C++17以降)
(C++20以降 constexpr)
basic_string & operator = ( std:: nullptr_t ) = delete ;
(7) (C++23以降)

文字列の内容を置き換えます。

1) 内容を str のコピーで置き換えます。 * this と str が同じオブジェクトである場合、この関数は何も行いません。
2) str の内容で置き換え、 SequenceContainer のムーブ代入セマンティクスを使用します。
他のシーケンスコンテナのムーブ代入とは異なり、 str の要素への参照、ポインタ、およびイテレータは無効化される可能性があります。
3) 内容を s が指すnull終端文字列の内容で置き換える。これは assign ( s, Traits :: length ( s ) ) を呼び出した場合と同様である。
4) 内容を文字 ch で置き換えます。これは assign ( std:: addressof ( ch ) , 1 ) を呼び出した場合と同様です。
5) 初期化子リストの内容で置き換えます ilist によって、あたかも assign ( ilist. begin ( ) , ilist. size ( ) ) のように。
6) 暗黙的に t を文字列ビュー sv に変換し（ std:: basic_string_view < CharT, Traits > sv = t ; による変換と同様）、その後 assign ( sv ) によって内容を sv の内容で置き換えます。
このオーバーロードは、以下の条件が満たされる場合にのみオーバーロード解決に参加します： std:: is_convertible_v < const StringViewLike & ,
std:: basic_string_view < CharT, Traits >> が true であり、かつ std:: is_convertible_v < const StringViewLike & , const CharT * > が false である場合です。
7) std::basic_string は nullptr から代入できません。

目次

パラメータ

ch - 文字列の文字を初期化する値
str - 文字列の初期化に使用するソース文字列
s - 文字列の初期化に使用するヌル終端文字列へのポインタ
ilist - std::initializer_list 文字列の初期化に使用する
t - std::basic_string_view に変換可能なオブジェクト（文字列の初期化に使用）

戻り値

* this

計算量

1) サイズに対して線形 str .
2) * this のサイズに対して線形（形式的には、各 CharT が破棄される必要がある）。アロケータが等しくなく伝播しない場合、 str のサイズに対しても線形（コピーが作成される必要がある）。
3) サイズ s に対して線形。
4) 定数。
5) ilist のサイズに対して線形。
6) サイズが t に対して線形。

例外

2)
noexcept specification:
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 をスローします。

何らかの理由で例外がスローされた場合、この関数は何も効果を持ちません（ strong exception safety guarantee ）。

例

このコードを実行 
#include <iomanip>
#include <iostream>
#include <string>
int main()
{
    std::string str1;
    std::string str2{"alpha"};
    // (1) operator=(const basic_string&);
    str1 = str2;
    std::cout << std::quoted(str1) << ' '   // "alpha"
              << std::quoted(str2) << '\n'; // "alpha"
    // (2) operator=(basic_string&&);
    str1 = std::move(str2);
    std::cout << std::quoted(str1) << ' '   // "alpha"
              << std::quoted(str2) << '\n'; // "" or "alpha" (unspecified)
    // (3) operator=(const CharT*);
    str1 = "beta";
    std::cout << std::quoted(str1) << '\n'; // "beta"
    // (4) operator=(CharT);
    str1 = '!'; 
    std::cout << std::quoted(str1) << '\n'; // "!"
    // (5) operator=(std::initializer_list<CharT>);
    str1 = {'g', 'a', 'm', 'm', 'a'};
    std::cout << std::quoted(str1) << '\n'; // "gamma"
    // (6) operator=(const T&);
    str1 = 35U; // equivalent to str1 = static_cast<char>(35U);
    std::cout << std::quoted(str1) << '\n'; // "#" (ASCII = 35)
}

出力例: 

"alpha" "alpha"
"alpha" ""
"beta"
"!"
"gamma"
"#"

不具合報告

以下の動作変更に関する欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。

DR 適用対象 公開時の動作 正しい動作
LWG 847 C++98 例外安全性保証が存在しなかった 強い例外安全性保証を追加
LWG 2063 C++11 ムーブ代入演算子が
SequenceContainer の意味要件に従っていなかった 		要件に従うように修正
LWG 2946 C++17 オーバーロード ( 6 ) が一部の場合に曖昧性を生じた テンプレート化することで回避

関連項目

basic_string を構築する
(公開メンバ関数)
文字列に文字を割り当てる
(公開メンバ関数)
ビューを割り当てる
( std::basic_string_view<CharT,Traits> の公開メンバ関数)