Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::basic_string::operator+= — añadir a una cadena

std::basic_string::operator+= añade caracteres al final de una cadena existente y devuelve una referencia a ella. Acepta otra cadena, un carácter, una cadena terminada en nulo, una lista de inicialización o un tipo compatible con string_view.

Versión: C++23; repository compiler flag, production runtime not attested

Sintaxis

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 el operando izquierdo al añadir contenido al final. Para std::string, charT es char; incluye <string>. El resultado tiene el tipo basic_string& y hace referencia al mismo objeto, lo que permite expresiones como (text += "a") += "b".

Las cinco sobrecargas aceptan const basic_string&, const charT*, charT, std::initializer_list<charT> y const T&. La última solo participa en la resolución de sobrecargas si const T& se puede convertir a std::basic_string_view<charT, traits>, pero no a const charT*. Las operaciones corresponden a llamadas a append; la sobrecarga de carácter añade exactamente un carácter.

La sobrecarga de puntero requiere una cadena válida terminada en nulo y deja de copiar antes del primer carácter nulo; no pases un puntero nulo. Las sobrecargas de cadena y vista conservan los caracteres nulos integrados gracias a sus longitudes explícitas. Para añadir un búfer de tamaño conocido, usa append(data, count).

Añadir contenido puede asignar memoria e invalidar referencias, punteros e iteradores a los elementos. Si se supera max_size(), se lanza std::length_error; si la operación lanza una excepción, el objeto cadena permanece sin cambios. Las fuentes proporcionadas presentan el borrador evolutivo del estándar, no un texto C++23 fijado.

Ejemplos

#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!!

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes