Appends additional characters to the string.

[edit]Parameters

[edit]Return value

*this

[edit]Complexity

There are no standard complexity guarantees, typical implementations behave similar tostd::vector::insert().

[edit]Exceptions

If the operation would causesize() to exceedmax_size(), throwsstd::length_error.

If an exception is thrown for any reason, this function has no effect (strong exception safety guarantee).

[edit]Notes

Overload(2) can accept any types that are implicitly convertible toCharT. Forstd::string, whereCharT ischar, the set of acceptable types includes all arithmetic types. This may have unintended effects.

[edit]Example

#include <iomanip>#include <iostream>#include <string> int main(){std::string str; // reserve sufficient storage space to avoid memory reallocation    str.reserve(50); 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+=69.96;// Equivalent to str += static_cast<char>(69.96);// 'E' (ASCII code 69) is appended by overload (2),// which might not be the intent. // To add a numeric value, consider 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"

[edit]Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

[edit]See also

• In other languages

• Deutsch
• Español
• Français
• Italiano
• 日本語
• Português
• Русский
• 中文