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

 

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)

 

size_type capacity()const;		(hasta C++11)
size_type capacity()constnoexcept;		(desde C++11) (hasta C++20)
constexpr size_type capacity()constnoexcept;		(desde C++20)

Devuelve el número de elementos para los que este contenedor tiene asignado espacio.

Parámetros

(Ninguno)

Valor de retorno

La capacidad del almacenamiento actualmente asignado.

Complejidad

Constante.

Ejemplo

Ejecuta este código

#include <iostream>#include <vector>   int main(){int sz =200;std::vector<int> v1;   auto cap = v1.capacity();std::cout<<"capacidad inicial="<< cap <<'\n';   for(int n =0; n < sz;++n){ v1.push_back(n);if(cap != v1.capacity()){ cap = v1.capacity();std::cout<<"nueva capacidad="<< cap <<'\n';}}   std::cout<<"tamaño final="<< v1.size()<<'\n';std::cout<<"capacidad final="<< v1.capacity()<<'\n';}

Posible salida:

capacidad inicial=0 nueva capacidad=1 nueva capacidad=2 nueva capacidad=4 nueva capacidad=8 nueva capacidad=16 nueva capacidad=32 nueva capacidad=64 nueva capacidad=128 nueva capacidad=256 tamaño final=200 capacidad final=256

Véase también

size	Devuelve el número de elementos. (función miembro pública)
reserve	Reserva almacenamiento. (función miembro pública)