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++ 표준에 소급 적용되었습니다.

참고 항목