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.