Partager via


vector::capacity (STL/CLR)

Signale la taille de l'espace de stockage alloué pour le conteneur.

    size_type capacity();

Notes

La fonction membre retourne le stockage actuellement allouée pour maintenir la séquence contrôlée, une valeur au moins aussi grande que vector::size (STL/CLR)().Vous l'utilisez pour déterminer la quantité le conteneur peut développer avant qu'il ne réaffecter le stockage pour la séquence contrôlée.

Exemple

// cliext_vector_capacity.cpp 
// compile with: /clr 
#include <cliext/vector> 
 
int main() 
    { 
    cliext::vector<wchar_t> c1; 
    c1.push_back(L'a'); 
    c1.push_back(L'b'); 
    c1.push_back(L'c'); 
 
// display initial contents " a b c" 
    for (int i = 0; i < c1.size(); ++i) 
        System::Console::Write(" {0}", c1.at(i)); 
    System::Console::WriteLine(); 
 
// increase capacity 
    cliext::vector<wchar_t>::size_type cap = c1.capacity(); 
    System::Console::WriteLine("capacity() = {0}, ok = {1}", 
        cap, c1.size() <= cap); 
    c1.reserve(cap + 5); 
    System::Console::WriteLine("capacity() = {0}, ok = {1}", 
        c1.capacity(), cap + 5 <= c1.capacity()); 
    return (0); 
    } 
 
  

Description

Notez que les capacités réelles peuvent différer des valeurs illustrées ici, à condition que le rapport des données de test d' ok la valeur true.

Configuration requise

en-tête :<cliext/vecteur>

Cliext del'espace de noms :

Voir aussi

Référence

vector (STL/CLR)

vector::reserve (STL/CLR)