Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes