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

 

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)

 

void shrink_to_fit();		(constexpr desde C++20)

Solicita la remoción de la capacidad sin usar.

Es una solicitud no vinculante para reducir la capacidad dada por capacity() a un tamaño dado size(). Depende de la implementación si se cumple la solicitud.

Si ocurre una reasignación de memoria, se invalidan todos los iteradores, incluyendo el iterador después del final y todas las referencias a los elementos. si no toma lugar ninguna reasignación de memoria, no se invalidan ni los iteradores ni las referencias.

Si T no es InsertablePorMovimiento en std::vector<T, Allocator>, el comportamiento no está definido.

(desde C++11)

Complejidad

A lo sumo lineal de acuerdo al tamaño del contenedor.

Exceptions Si se lanza una excepción que no sea el constructor de movimiento de un tipo T que no sea InsertablePorCopia, no hay efectos.

(desde C++11)

Notas

En libstdc++, shrink_to_fit() no está disponible en modalidad C++98.

Ejemplo

Ejecuta este código

#include <iostream>
#include <vector>

int main()
{
    std::vector<int> v;
    std::cout << "Capacidad construida por defecto es " << v.capacity() << '\n';
    v.resize(100);
    std::cout << "Capacidad de un vector de 100 elementos es " << v.capacity() << '\n';
    v.resize(50);
    std::cout << "Capacidad después de resize(50) es " << v.capacity() << '\n';
    v.shrink_to_fit();
    std::cout << "Capacidad después de shrink_to_fit() es " << v.capacity() << '\n';
    v.clear();
    std::cout << "Capacidad después de clear() es " << v.capacity() << '\n';
    v.shrink_to_fit();
    std::cout << "Capacidad después de shrink_to_fit() es " << v.capacity() << '\n';
    for (int i = 1000; i < 1300; ++i)
        v.push_back(i);
    std::cout << "Capacidad después de agregar 300 elementos es " << v.capacity() << '\n';
    v.shrink_to_fit();
    std::cout << "Capacidad después de shrink_to_fit() es " << v.capacity() << '\n';
}

Posible salida:

Capacidad construida por defecto es 0
Capacidad de un vector de 100 elementos es 100
Capacidad después de resize(50) es 100
Capacidad después de shrink_to_fit() es 50
Capacidad después de clear() es 50
Capacidad después de shrink_to_fit() es 0
Capacidad después de agregar 300 elementos es 512
Capacidad después de shrink_to_fit() es 300

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 755	C++98	std::vector carecía de operaciones explícitas de reducción para ajustar.	Se proporcionaron.
LWG 2033	C++98 C++11	1. Faltaba el requisito de complejidad (C++98) 2. No se requería que T fuera InsertablePorMovimiento (C++11)	1. Se agregó. 2. Se requiere.
LWG 2223	C++98 C++11	1. Las referencias, punteros e iteradores no se invalidaban (C++98) 2. No había garantía de seguridad de excepciones (C++11)	1. Pueden invalidarse. 2. Se agregó.

Véase también

size	Devuelve el número de elementos. (función miembro pública)
capacity	Devuelve el número de elementos que se pueden almacenar en el almacenamiento asignado actualmente. (función miembro pública)