std::basic_string::operator+=

 

C++

Apoyo de compiladores

Implementaciones independientes y albergadas

Lenguaje

Biblioteca estándar

Encabezados de la biblioteca estándar

Requisitos denominados

Macros de prueba de característica (C++20)

Biblioteca de apoyo del lenguaje

Biblioteca de conceptos(C++20)

Biblioteca de diagnósticos

Biblioteca de gestión de memoria

Biblioteca de metaprogramación(C++11)

Biblioteca de servicios generales

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos(C++20)

Biblioteca de algoritmos

Biblioteca de cadenas

Biblioteca de procesamiento de texto

Biblioteca numérica

Biblioteca de fecha y hora

Biblioteca de entrada/salida

Biblioteca del sistema de archivos(C++17)

Biblioteca de apoyo de concurrencia(C++11)

Biblioteca de apoyo de ejecución(C++26)

Especificaciones técnicas

Índice de símbolos

Bibliotecas externas

 

Biblioteca de cadenas

Cadenas terminadas en nulo

Cadenas de bytes

Cadenas multibyte

De caracteres anchos

Clases

basic_string

basic_string_view (C++17)

char_traits

 

std::basic_string

Funciones miembro basic_string::basic_string basic_string::operator= basic_string::assign basic_string::get_allocator Acceso a elementos basic_string::at basic_string::operator[] basic_string::front (C++11) basic_string::back (C++11) basic_string::data basic_string::c_str basic_string::operator basic_string_view (C++17) Iteradores basic_string::beginbasic_string::cbegin (C++11) basic_string::endbasic_string::cend (C++11) basic_string::rbeginbasic_string::crbegin (C++11) basic_string::rendbasic_string::crend (C++11) Capacidad basic_string::empty basic_string::sizebasic_string::length basic_string::max_size basic_string::reserve basic_string::capacity basic_string::shrink_to_fit (C++11)

Operaciones basic_string::clear basic_string::insert basic_string::erase basic_string::push_back basic_string::pop_back (C++11) basic_string::append basic_string::operator+= basic_string::compare basic_string::starts_with (C++20) basic_string::ends_with (C++20) basic_string::replace basic_string::substr basic_string::copy basic_string::resize basic_string::swap Búsqueda basic_string::find basic_string::rfind basic_string::find_first_of basic_string::find_first_not_of basic_string::find_last_of basic_string::find_last_not_of Constantes basic_string::npos

Funciones no miembro operator+ swap(std::basic_string) operator""s (C++14) erase(std::basic_string)erase_if(std::basic_string) (C++20)(C++20) E/S operator<<operator>> getline Comparación operator==operator!=operator<operator>operator<=operator>=operator<=> (hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)(C++20) Conversión numérica (C++11) stoistolstoll stoulstoull stofstodstold to_string to_wstring Clases auxiliares hash<std::string>hash<std::wstring>hash<std::u32string>hash<std::u16string>hash<std::u8string> (C++11)(C++11)(C++11)(C++11)(C++20) hash<std::pmr::string>hash<std::pmr::wstring>hash<std::pmr::u32string>hash<std::pmr::u16string>hash<std::pmr::u8string> (C++20)(C++20)(C++20)(C++20)(C++20) Guías de deducción(C++17)

 

	(1)
basic_string& operator+=(const basic_string& str );			(hasta C++20)
constexpr basic_string& operator+=(const basic_string& str );			(desde C++20)
		(2)
basic_string& operator+=( CharT ch );				(hasta C++20)
constexpr basic_string& operator+=( CharT ch );				(desde C++20)
			(3)
basic_string& operator+=(const CharT* s );					(hasta C++20)
constexpr basic_string& operator+=(const CharT* s );					(desde C++20)
				(4)
basic_string& operator+=(std::initializer_list<CharT> ilist );						(desde C++11) (hasta C++20)
constexpr basic_string& operator+=(std::initializer_list<CharT> ilist );						(desde C++20)
					(5)
template<class T > basic_string& operator+=(const T& t );							(desde C++17) (hasta C++20)
template<class T > constexpr basic_string& operator+=(const T& t );							(desde C++20)

Añade caracteres adicionales a la cadena.

1) Añade la cadena str.

2) Añade el carácter ch.

3) Añade la cadena de caracteres terminada en nulo apuntada por s.

4) Añade los caracteres en la lista de inicializadores ilist.

5) Implícitamente convierte t a una vista sobre cadena sv como si fuera mediante std::basic_string_view<CharT, Traits> sv = t;, entonces añade caracteres en la vista sobre cadena sv como si fuera mediante append(sv). Esta sobrecarga solo participa en la resolución de sobrecargas si std::is_convertible_v<const T&, std::basic_string_view<CharT, Traits>> es true y std::is_convertible_v<const T&, const CharT*> es false.

Parámetros

str	-	Cadena a añadir
ch	-	Valor del carácter a añadir
s	-	Puntero a una cadena de caracteres terminada en nulo a añadir.
ilist	-	std::initializer_list con los caracteres a añadir.
t	-	Objeto convertible a std::basic_string_view con los caracteres a añadir.

Valor de retorno

*this

Complejidad

No existen garantías estándar de complejidad. Las implementaciones típicas se comportan de manera similar a std::vector::insert.

Excepciones

Si por alguna razón se lanza una excepción, esta función no tiene efecto (garantía de excepción fuerte).(desde C++11)

Si la operación resultara en size() > max_size(), lanza std::length_error.

Notas

La sobrecarga (2) puede aceptar cualquier tipo que sea implícitamente convertible a CharT. Para std::string, donde CharT es char, el conjunto de tipos aceptables incluye todos los tipos aritméticos. Esto puede tener efectos no deseados.

Informes de defectos

Los siguientes informes de defectos de cambio de comportamiento se aplicaron de manera retroactiva a los estándares de C++ publicados anteriormente.

ID	Aplicado a	Comportamiento según lo publicado	Comportamiento correcto
LWG 2946	C++17	La sobrecarga string_view ocasiona ambigüedad en algunos casos.	Se evitó haciéndola una plantilla.

Ejemplo

Ejecuta este código

#include <iostream>#include <iomanip>#include <string>   int main(){std::string str; str.reserve(50);//reserva suficiente espacio de almacenamiento para evitar reasignación de memoriastd::cout<<std::quoted(str)<<'\n';//cadena vacía   str +="Esta";std::cout<<std::quoted(str)<<'\n';   str +=std::string(" es ");std::cout<<std::quoted(str)<<'\n';   str +='una';std::cout<<std::quoted(str)<<'\n';   str +={' ','c','a','d','e','n','a','.'};std::cout<<std::quoted(str)<<'\n';   str +=76.85;// equivalente a str += static_cast<char>(76.85), puede que no sea la intenciónstd::cout<<std::quoted(str)<<'\n';}

Salida:

"" "Esta" "Esta es " "Esta es una" "Esta es una cadena." "Esta es una cadena.L"

Véase también

append

Añade caracteres al final (función miembro pública)