std::basic_string<CharT,Traits,Allocator>::assign

basic_string& assign( const basic_string& str );	(1)	(constexpr desde C++20)
basic_string& assign( basic_string&& str ) noexcept(/* see below */);	(2)	(desde C++11) (constexpr desde C++20)
basic_string& assign( size_type count, CharT ch );	(3)	(constexpr desde C++20)
basic_string& assign( const CharT* s, size_type count );	(4)	(constexpr desde C++20)
basic_string& assign( const CharT* s );	(5)	(constexpr desde C++20)
template< class SV > basic_string& assign( const SV& t );	(6)	(desde C++17) (constexpr desde C++20)
template< class SV > basic_string& assign( const SV& t, size_type pos, size_type count = npos);	(7)	(desde C++17) (constexpr desde C++20)
basic_string& assign( const basic_string& str, size_type pos, size_type count );	(8)	(hasta C++14)
basic_string& assign( const basic_string& str, size_type pos, size_type count = npos);	(8)		(desde C++14) (constexpr desde C++20)
template< class InputIt > basic_string& assign( InputIt first, InputIt last );	(9)	(constexpr desde C++20)
basic_string& assign( std::initializer_list<CharT> ilist );	(10)	(desde C++11) (constexpr desde C++20)

Reemplaza el contenido de la cadena.

1) Equivalente a return *this = str;.

2) Equivalente a return *this = std::move(str);.

3) Reemplaza el contenido con count copias del carácter ch.

Equivalente a clear(); resize(n, c); return *this;.

4) Reemplaza el contenido con copias de los caracteres en el rango [s, s + count).

Si [s, s + count) no es un rango válido, el comportamiento no está definido.

5) Equivalente a return assign(s, Traits::length(s));.

6,7) Reemplaza el contenido con caracteres de una vista de cadena sv construida a partir de t.

Si solo se proporciona t, reemplaza el contenido con todos los caracteres en sv.
Si también se proporciona pos:
- Si count es npos, reemplaza el contenido con todos los caracteres en sv comenzando desde pos.
- De lo contrario, reemplaza el contenido con los std::min(count, sv.size() - pos) caracteres en sv comenzando desde pos.

Estas sobrecargas participan en la resolución de sobrecargas solo si se cumplen todas las condiciones siguientes:

std::is_convertible_v<const SV&, std::basic_string_view<CharT, Traits>> es true.
std::is_convertible_v<const SV&, const CharT*> es false.

6) Equivalente a std::basic_string_view<CharT, Traits> sv = t;
return assign(sv.data(), sv.size());.

7) Equivalente a std::basic_string_view<CharT, Traits> sv = t;
return assign(sv.substr(pos, count));.

8) Reemplaza el contenido con caracteres en str.

Si count es npos, reemplaza el contenido con todos los caracteres en str comenzando desde pos.
De lo contrario, reemplaza el contenido con los std::min(count, str.size() - pos) caracteres en str comenzando desde pos.

Equivalente a return assign(std::basic_string_view<CharT, Traits>
(str).substr(pos, count));.

(desde C++20)

9) Equivalente a return assign(basic_string(first, last, get_allocator()));.

Esta sobrecarga participa en la resolución de sobrecargas solo si InputIt satisface los requisitos de LegacyInputIterator.

(desde C++11)

10) Equivalente a return assign(ilist.begin(), ilist.size());.

Parámetros

str	-	cadena que se utilizará como fuente para inicializar los caracteres
count	-	tamaño de la cadena resultante
ch	-	valor para inicializar los caracteres de la cadena
s	-	puntero a una cadena de caracteres para usar como fuente para inicializar la cadena
t	-	objeto (convertible a std::basic_string_view ) para inicializar los caracteres de la cadena
pos	-	índice del primer carácter a tomar
first, last	-	rango desde el cual copiar los caracteres
ilist	-	std::initializer_list para inicializar los caracteres de la cadena

Valor de retorno

* this

Excepciones

2)

noexcept especificación:

noexcept ( std:: allocator_traits < Allocator > ::

propagate_on_container_move_assignment :: value ||

std:: allocator_traits < Allocator > :: is_always_equal :: value )

Si la operación causara que size() exceda max_size() , lanza std::length_error .

7) Si pos > sv. size ( ) es true , lanza std::out_of_range .

8) Si pos > str. size ( ) es true , lanza std::out_of_range .

Si se lanza una excepción por cualquier razón, esta función no tiene efecto ( strong exception safety guarantee ).

Ejemplo

Ejecutar este código

#include <iostream>
#include <iterator>
#include <string>
int main()
{
    std::string s;
    // assign(size_type count, CharT ch)
    s.assign(4, '=');
    std::cout << s << '\n'; // "===="
    std::string const c("Exemplary");
    // assign(const basic_string& str)
    s.assign(c);
    std::cout << c << " == " << s << '\n'; // "Exemplary == Exemplary"
    // assign(const basic_string& str, size_type pos, size_type count)
    s.assign(c, 0, c.length() - 1);
    std::cout << s << '\n'; // "Exemplar";
    // assign(basic_string&& str)
    s.assign(std::string("C++ by ") + "example");
    std::cout << s << '\n'; // "C++ by example"
    // assign(const CharT* s, size_type count)
    s.assign("C-style string", 7);
    std::cout << s << '\n'; // "C-style"
    // assign(const CharT* s)
    s.assign("C-style\0string");
    std::cout << s << '\n'; // "C-style"
    char mutable_c_str[] = "C-style string";
    // assign(InputIt first, InputIt last)
    s.assign(std::begin(mutable_c_str), std::end(mutable_c_str) - 1);
    std::cout << s << '\n'; // "C-style string"
    // assign(std::initializer_list<CharT> ilist)
    s.assign({'C', '-', 's', 't', 'y', 'l', 'e'});
    std::cout << s << '\n'; // "C-style"
}

Salida:

====
Exemplary == Exemplary
Exemplar
C++ by example
C-style
C-style
C-style string
C-style

Informes de defectos

Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares de C++ publicados anteriormente.

DR	Aplicado a	Comportamiento publicado	Comportamiento correcto
LWG 847	C++98	no existía garantía de seguridad de excepciones	se añadió garantía fuerte de seguridad de excepciones
LWG 2063	C++11	una nota no normativa indicaba que la sobrecarga ( 2 ) podía implementarse mediante intercambio	se corrigió para requerir asignación de movimiento
LWG 2250	C++98	el comportamiento de la sobrecarga ( 8 ) era indefinido si pos > str. size ( ) es true	siempre lanza una excepción en este caso
LWG 2579	C++98	la sobrecarga ( 1 ) y el operador de asignación de copia tenían efectos diferentes	tienen el mismo efecto
LWG 2946	C++17	la sobrecarga ( 6 ) causaba ambigüedad en algunos casos	se evitó haciéndola una plantilla

Véase también

assign_range (C++23)	asigna un rango de caracteres a una cadena (función miembro pública)
(constructor)	construye un `basic_string` (función miembro pública)
operator=	asigna valores a la cadena (función miembro pública)

Soporte del compilador
Independiente y alojado
Lenguaje
Biblioteca estándar
Encabezados de la biblioteca estándar
Requisitos nombrados
Macros de prueba de características (C++20)
Biblioteca de soporte del lenguaje
Biblioteca de conceptos (C++20)
Biblioteca de diagnóstico
Biblioteca de gestión de memoria
Biblioteca de metaprogramación (C++11)
Biblioteca de utilidades 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 soporte de concurrencia (C++11)
Biblioteca de control de ejecución (C++26)
Especificaciones técnicas
Índice de símbolos
Bibliotecas externas

Clases
basic_string
basic_string_view (C++17)
char_traits

es.cppreference.net

Namespaces

Variants