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

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 "> </tbody><tbody> </tbody>

size_type capacity() const;		(hasta C++11)
size_type capacity() const noexcept;		(desde C++11) (hasta C++20)
constexpr size_type capacity() const noexcept;		(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)