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

basic_string& operator+=( const basic_string& str );

basic_string& operator+=( CharT ch );

basic_string& operator+=( const CharT* s );

basic_string& operator+=( std::initializer_list<CharT> ilist );

template< class StringViewLike >
basic_string& operator+=( const StringViewLike& t );

文字列に追加の文字を加えます。

パラメータ

戻り値

* this

計算量

標準的な計算量の保証はありません。一般的な実装は std::vector::insert() と同様の動作をします。

例外

操作によって size() が max_size() を超える場合、 std::length_error をスローします。

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

注記

オーバーロード ( 2 ) は、 CharT に暗黙的に変換可能なあらゆる型を受け入れます。 std::string の場合、 CharT が char であるため、受け入れ可能な型のセットにはすべての算術型が含まれます。これは意図しない効果をもたらす可能性があります。

例

#include <iomanip>
#include <iostream>
#include <string>
int main()
{
    std::string str;
    // メモリ再割り当てを避けるために十分なストレージ領域を予約
    str.reserve(50);
    std::cout << std::quoted(str) << '\n'; // 空文字列
    str += "This";
    std::cout << std::quoted(str) << '\n';
    str += std::string(" is ");
    std::cout << std::quoted(str) << '\n';
    str += 'a';
    std::cout << std::quoted(str) << '\n';
    str += {' ', 's', 't', 'r', 'i', 'n', 'g', '.'};
    std::cout << std::quoted(str) << '\n';
    str += 69.96; // str += static_cast<char>(69.96); と同等
                  // オーバーロード (2) によって 'E' (ASCIIコード 69) が追加されるが、
                  // これは意図した動作ではない可能性がある
    // 数値を追加するには、std::to_string() の使用を検討すること：
    str += std::to_string(1729);
    std::cout << std::quoted(str) << '\n';
}

""
"This"
"This is "
"This is a"
"This is a string."
"This is a string.E1729"

不具合報告

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

関連項目