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

See More

 

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)

 

<tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody>

	(1)
void resize( size_type count );			(desde C++11) (hasta C++20)
constexpr void resize( size_type count );			(desde C++20)
		(2)
void resize( size_type count, T value = T() );				(hasta C++11)
void resize( size_type count, const value_type& value );				(desde C++11) (hasta C++20)
constexpr void resize( size_type count, const value_type& value );				(desde C++20)

Cambia el tamaño del contenedor para que contenga count elementos.

Si el tamaño actual es mayor que count, el contenedor se reduce a sus primeros count elementos.

Si el tamaño actual es menor que count,

1) se añaden elementos adicionales insertados por defecto.

2) se añaden copias adicionales de value.

Parámetros

count	-	Nuevo tamaño del contenedor.
value	-	El valor con el cual inicializar los nuevos elementos.
Requisitos de tipo
- T debe satisfacer los requisitos de InsertablePorMovimiento y InsertablePorDefecto para poder usar la sobrecarga (1).
- T debe satisfacer los requisitos de InsertablePorCopia para poder usar la sobrecarga (2).

Valor de retorno

(Ninguno)

Complejidad

Lineal en la diferencia entre el tamaño actual y count. Complejidad adicional posible debido a la reasignación de memoria si la capacidad es menor que count.

Excepciones

Si se lanza una excepción, esta función no tiene efecto (garantía de excepción fuerte).

En la sobrecarga (1), si el constructor de movimiento de T no es noexcept y T no es CopyInsertable en *this, el vector utilizará el constructor de movimiento que lanza una excepción. Si lanza, se anula la garantía y los efectos no están especificados.

(desde C++11)

Notas

Si la inicialización de valor en la sobrecarga (1) no se desea, por ejemplo, si los elementos son de un tipo no clase y no se necesita ponerlos a cero, esto se puede evitar proporcionando una implementación de Allocator::construct personalizada.
La capacidad del vector nunca se reduce cuando se cambia el tamaño a un tamaño más pequeño porque eso invalidaría todos los iteradores, en lugar de solo los que serían invalidados por la secuencia equivalente de llamadas a pop_back().

Ejemplo

Ejecuta este código

#include <iostream>
#include <vector>
int main()
{
    std::vector<int> c = {1, 2, 3};
    std::cout << "El objeto tipo vector alberga: ";
    for(const auto& el: c) std::cout << el << ' ';
    std::cout << '\n';
    c.resize(5);
    std::cout << "Después de aumentar el tamaño a 5: ";
    for(const auto& el: c) std::cout << el << ' ';
    std::cout << '\n';
    c.resize(2);
    std::cout << "Después de disminuir el tamaño 2: ";
    for(const auto& el: c) std::cout << el << ' ';
    std::cout << '\n';
    c.resize(6, 4);
    std::cout << "Después de aumentar el tamaño a 6 (inicializador = 4): ";
    for(const auto& el: c) std::cout << el << ' ';
    std::cout << '\n';
}

Salida:

El objeto tipo vector alberga: 1 2 3
Después de aumentar el tamaño a 5: 1 2 3 0 0
Después de disminuir el tamaño 2: 1 2
Después de aumentar el tamaño a 6 (inicializador = 4): 1 2 4 4 4 4

Véase también

size	Devuelve el número de elementos. (función miembro pública)
insert	Inserta elementos (función miembro pública)
erase	Borra elementos (función miembro pública)