Bibliothèque de vecteurs C ++ - fonction capacity ()

La description

La fonction C ++ std::vector::capacity() renvoie la taille du stockage alloué, exprimée en termes d'éléments.

Cette capacité n'est pas nécessairement égale à la taille du vecteur. Elle peut être égale ou supérieure à la taille du vecteur.

La limite théorique de la taille du vecteur est donnée par le membre max_size .

Déclaration

Voici la déclaration de la fonction std :: vector :: capacity () sous forme d'en-tête std :: vector.

C ++ 98

size_type capacity() const;

C ++ 11

size_type capacity() const noexcept;

Paramètres

Aucun

Valeur de retour

Renvoie la taille du stockage alloué, exprimée en termes de nombre d'éléments pouvant être conservés par vecteur.

Exceptions

Cette fonction membre ne lève jamais d'exception.

Complexité temporelle

Constante ie O (1)

Exemple

L'exemple suivant montre l'utilisation de la fonction 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;
}

Compilons et exécutons le programme ci-dessus, cela produira le résultat suivant -

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