std::vector<T,Allocator>::append_range

 

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 contenedores

De secuencias

array (C++11)

vector

vector<bool>

inplace_vector (C++26)

deque

forward_list (C++11)

list

Asociativos

set

multiset

map

multimap

Asociativos no ordenados

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

Adaptadores

stack

queue

priority_queue

flat_set (C++23)

flat_multiset (C++23)

flat_map (C++23)

flat_multimap (C++23)

Vistas

span (C++20)

mdspan (C++23)

Tablas

Invalidación de iteradores

Tabla de funciones miembro

Tabla de funciones no miembro

 

std::vector

Tipos miembro
Funciones miembro
vector::vector vector::~vector vector::operator=	vector::assign vector::assign_range (C++23) vector::get_allocator
Acceso a elementos
vector::at vector::operator[] vector::front	vector::back vector::data
Iteradores
vector::beginvector::cbegin (C++11) vector::endvector::cend (C++11)	vector::rbeginvector::crbegin (C++11) vector::rendvector::crend (C++11)
Capacidad
vector::empty vector::size vector::max_size	vector::reserve vector::capacity vector::shrink_to_fit (DR*)
Modificadores
vector::clear vector::insert vector::emplace (C++11) vector::insert_range (C++23)   vector::erase vector::push_back	vector::emplace_back (C++11) vector::append_range (C++23) vector::pop_back vector::resize vector::swap
Funciones no miembro
operator==operator!=operator<operator>operator<=operator>=operator<=> (hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)(C++20)	swap(std::vector) erase(std::vector)erase_if(std::vector) (C++20)(C++20)
Guías de deducción(C++17)

 

template< rango-compatible-con-contenedores<T> R > constexprvoid append_range( R&& rg );		(desde C++23)

Inserta copias de elementos del rango rg antes de end(), en orden no inverso.

Cada iterador en rg se desreferencia exactamente una vez.

Parámetros

rg	-	Un rango compatible con contenedores, es decir, un input_range cuyos elementos son convertibles a T.
Requisitos de tipo
- T debe ser EmplaceConstructible en vector de *ranges::begin(rg). También, T debe ser MoveInsertable en vector. De lo contrario, el comportamiento no está definido.

Valor de retorno

(Ninguno)

Complejidad

Si ocurre una reasignación, lineal en el número de elementos del vector resultante; en caso contrario, lineal en el número de elementos insertados más la distancia al end().

Excepciones

Si se lanza una excepción que no sea por el constructor de copia, el constructor de movimiento, el operador de asignación o el operador de asignación de movimiento de T, o por cualquier operación de un InputIterator no hay efectos. Si se lanza una excepción al insertar un solo elemento al final y T es CopyInsertable o std::is_nothrow_move_constructible_v<T> es true, no hay efectos. De lo contrario, si la excepción se lanza por el constructor de movimiento de un tipo T que no es CopyInsertable, los efectos no se especifican.

Notas

Macro de Prueba de característica	Valor	Estándar	Comentario
__cpp_lib_containers_ranges	202202L	(C++23)	Construcción e inserción consciente de rangos.

Ejemplo

Ejecuta este código

#include <algorithm>#include <cassert>#include <vector>#include <list>   int main(){auto head =std::vector{1, 2, 3, 4};constauto tail =std::list{-5, -6, -7};#ifdef __cpp_lib_containers_ranges head.append_range(tail);#else head.insert(head.end(), tail.cbegin(), tail.cend());#endifassert(std::ranges::equal(head, std::vector{1, 2, 3, 4, -5, -6, -7}));}

Véase también

insert_range (C++23)	Inserta un rango de elementos. (función miembro pública)
push_back	Agrega elementos al final. (función miembro pública)
emplace_back (C++11)	Construye un elemento en el sitio al final. (función miembro pública)