名前空間
変種
操作

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

提供: cppreference.com
< cpp‎ | string‎ | basic string
 
 
 
std::basic_string
 
basic_string& operator+=( const basic_string& str );
(1)
basic_string& operator+=( CharT ch );
(2)
basic_string& operator+=( const CharT* s );
(3)
basic_string& operator+=( std::initializer_list<CharT> ilist );
(4) (C++11以上)
template < class T >
basic_string& operator+=( const T& t );
(5) (C++17以上)

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

1) 文字列 str を追加します。
2) 文字 ch を追加します。
3) s の指すヌル終端文字列を追加します。
4) 初期化子リスト ilist 内の文字を追加します。
5) std::basic_string_view<CharT, Traits> sv = t; によって行われたかのように、 t を文字列ビュー sv に暗黙に変換し、 append(sv) によって行われたかのように文字列ビュー sv 内の文字を追加します。 このオーバーロードは、std::is_convertible_v<const T&, std::basic_string_view<CharT, Traits>>true であり、 std::is_convertible_v<const T&, const CharT*>false である場合にのみ、オーバーロード解決に参加します。

目次

[編集] 引数

str - 追加する文字列
ch - 追加する文字値
s - 追加するヌル終端文字列を指すポインタ
ilist - 追加する文字を持つ std::initializer_list
t - 追加する文字を持つ (std::basic_string_view に変換可能な) オブジェクト

[編集] 戻り値

*this

[編集] 計算量

1) str のサイズに比例。
2) 一定。
3) s のサイズに比例。
4) ilist のサイズに比例。

[編集] 例外

何らかの理由で例外が投げられた場合、この関数は効果を持ちません (強い例外保証)。 (C++11以上)

操作の結果 size() > max_size() となる場合は std::length_error を投げます。

[編集] ノート

オーバーロード (2)CharT に暗黙に変換可能な任意の型を受け付けます。 CharTchar である std::string の場合、受け付ける型の集合にすべての算術型が含まれます。 これは意図しない結果を生むことがあります。

[編集] 欠陥報告

以下の動作変更欠陥報告は以前に発行された C++ 標準に遡って適用されました。

DR 適用先 発行時の動作 正しい動作
LWG 2946 C++17 string_view overload causes ambiguity in some cases avoided by making it a template

[編集]

#include <iostream>
#include <iomanip>
#include <string>
 
int main()
{
   std::string str;
   str.reserve(50); //reserves sufficient storage space to avoid memory reallocation
   std::cout << std::quoted(str) << '\n'; //empty string
 
   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 += 76.85; // equivalent to str += static_cast<char>(76.85), might not be the intent
   std::cout << std::quoted(str) << '\n';
}

出力:

""
"This"
"This is "
"This is a"
"This is a string."
"This is a string.L"

[編集] 関連項目

文字を末尾に追加します
(パブリックメンバ関数) [edit]