vecteur : : réserve (STL/CLR)
Garantit une capacité minimale de croissance pour le conteneur.
void reserve(size_type count);
Paramètres
- count
Nouvelle capacité minimale pour le conteneur.
Notes
La fonction membre garantit que capacity() retourne dorénavant au moins count. Vous l'utilisez pour vous assurer que le conteneur n'a pas besoin de réallocation le stockage pour la séquence contrôlée tant qu'il n'a pas dépassé la taille spécifiée.
Exemple
// cliext_vector_reserve.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 pour le nom : cliext