C ++ Vector Library - funzione capacity ()

Descrizione

La funzione C ++ std::vector::capacity() restituisce la dimensione dello spazio di archiviazione allocato, espressa in termini di elementi.

Questa capacità non è necessariamente uguale alla dimensione del vettore. Può essere uguale o maggiore della dimensione del vettore.

Il limite teorico sulla dimensione del vettore è dato dal membro max_size .

Dichiarazione

Di seguito è riportata la dichiarazione per la funzione std :: vector :: capacity () nel formato std :: vector header.

C ++ 98

size_type capacity() const;

C ++ 11

size_type capacity() const noexcept;

Parametri

Nessuna

Valore di ritorno

Restituisce la dimensione della memoria allocata, espressa in termini di numero di elementi che possono essere contenuti dal vettore.

Eccezioni

Questa funzione membro non genera mai eccezioni.

Complessità temporale

Costante cioè O (1)

Esempio

L'esempio seguente mostra l'utilizzo della funzione 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;
}

Compiliamo ed eseguiamo il programma sopra, questo produrrà il seguente risultato:

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