Biblioteca de vectores de C ++ - función capacity ()

Descripción

La función C ++ std::vector::capacity() devuelve el tamaño del almacenamiento asignado, expresado en términos de elementos.

Esta capacidad no es necesariamente igual al tamaño del vector. Puede ser igual o mayor que el tamaño del vector.

El límite teórico del tamaño del vector viene dado por el miembro max_size .

Declaración

A continuación se muestra la declaración de la función std :: vector :: capacity () del encabezado std :: vector.

C ++ 98

size_type capacity() const;

C ++ 11

size_type capacity() const noexcept;

Parámetros

Ninguna

Valor devuelto

Devuelve el tamaño del almacenamiento asignado, expresado en términos de número de elementos que puede contener el vector.

Excepciones

Esta función miembro nunca lanza una excepción.

Complejidad del tiempo

Constante es decir O (1)

Ejemplo

El siguiente ejemplo muestra el uso de la función std :: vector :: capacity ().

#include <iostream>
#include <vector>

using namespace std;

int main(void) {
   vector<int> v;

   for (int i = 0; i < 5; ++i)
      v.push_back(i + 1);

   cout << "Number of elements in vector = " << v.size() << endl;
   cout << "Capacity of vector           = " << v.capacity() << endl;

   return 0;
}

Compilemos y ejecutemos el programa anterior, esto producirá el siguiente resultado:

Number of elements in vector = 5
Capacity of vector           = 8