CKTIS / C++
std::basic_string::operator+= — acrescentar a uma cadeia
std::basic_string::operator+= acrescenta caracteres ao fim de uma cadeia existente e devolve uma referência para ela. Aceita outra cadeia, um único carácter, uma cadeia terminada em nulo, uma lista de inicialização ou um tipo compatível com string_view.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
constexpr basic_string& operator+=(const basic_string& str);
template<class T> constexpr basic_string& operator+=(const T& t);
constexpr basic_string& operator+=(const charT* s);
constexpr basic_string& operator+=(charT c);
constexpr basic_string& operator+=(std::initializer_list<charT> il);std::basic_string::operator+= modifica o operando da esquerda, acrescentando conteúdo ao fim. Para std::string, charT é char; inclui <string>. O resultado tem o tipo basic_string& e refere-se ao mesmo objeto, permitindo expressões como (text += "a") += "b".
As cinco sobrecargas aceitam const basic_string&, const charT*, charT, std::initializer_list<charT> e const T&. A última só participa na resolução de sobrecargas quando const T& é convertível para std::basic_string_view<charT, traits>, mas não para const charT*. As operações correspondem a chamadas a append; a sobrecarga de carácter acrescenta exatamente um carácter.
A sobrecarga de ponteiro exige uma cadeia válida terminada em nulo e interrompe a cópia antes do primeiro carácter nulo; não passes um ponteiro nulo. As sobrecargas de cadeia e vista preservam os caracteres nulos incorporados graças aos comprimentos explícitos. Para acrescentar um buffer de tamanho conhecido, usa append(data, count).
O acrescento pode alocar memória e invalidar referências, ponteiros e iteradores para os elementos. Ultrapassar max_size() lança std::length_error; se a operação lançar uma exceção, o objeto cadeia permanece inalterado. As fontes fornecidas apresentam o projeto de norma em evolução, não um texto C++23 fixo.
Exemplos
#include <iostream>
#include <string>
#include <string_view>
int main() {
std::string text = "C";
text += std::string("++");
text += ' ';
text += "is";
text += std::string_view(" useful");
(text += {'!', '!'}) += '\n';
std::cout << text;
}
Resultado
C++ is useful!!
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.