vecteur : : capacité (STL/CLR)
Signale la taille de l'espace de stockage alloué pour le conteneur.
size_type capacity();
Notes
La fonction membre retourne l'espace actuellement alloué pour contenir la séquence contrôlée, une valeur au moins égale à vecteur : : taille (STL/CLR)(). Vous l'utilisez pour déterminer la quantité avec laquelle le conteneur peut croître avant qu'il doive réallouer le stockage de 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 présentées ici, à condition que tous les tests ok affichent vrai.
Configuration requise
En-tête : <cliext/vector>
Espace de noms cliext