std::vector<T,Allocator>:: resize

Redimensionne le conteneur pour contenir count éléments :

• Si count est égal à la taille actuelle, ne fait rien.
• Si la taille actuelle est supérieure à count , le conteneur est réduit à ses premiers count éléments.
• Si la taille actuelle est inférieure à count , alors :

Paramètres

Complexité

Linéaire dans la différence entre la taille actuelle et count . Complexité supplémentaire possible due à la réallocation si la capacité est inférieure à count .

Exceptions

Si une exception est levée pour quelque raison que ce soit, ces fonctions n'ont aucun effet ( garantie de sécurité d'exception forte ). Bien que non explicitement spécifié, std::length_error est levé si la capacité requise par le nouveau vector dépasse max_size() .

Notes

Si l'initialisation par défaut dans la surcharge ( 1 ) est indésirable, par exemple si les éléments sont de type non-classe et que la mise à zéro n'est pas nécessaire, elle peut être évitée en fournissant un personnalisé Allocator::construct .
La capacité du vecteur n'est jamais réduite lors du redimensionnement vers une taille plus petite car cela invaliderait tous les itérateurs, alors que la spécification n'invalide que les itérateurs vers/après les éléments effacés.

Exemple

#include <vector>
#include <iostream>
void print(auto rem, const std::vector<int>& c)
{
    for (std::cout << rem; const int el : c)
        std::cout << el << ' ';
    std::cout << '\n';
}
int main()
{
    std::vector<int> c = {1, 2, 3};
    print("The vector holds: ", c);
    c.resize(5);
    print("After resize up to 5: ", c);
    c.resize(2);
    print("After resize down to 2: ", c);
    c.resize(6, 4);
    print("After resize up to 6 (initializer = 4): ", c);
}

The vector holds: 1 2 3
After resize up to 5: 1 2 3 0 0
After resize down to 2: 1 2
After resize up to 6 (initializer = 4): 1 2 4 4 4 4

Rapports de défauts

Les rapports de défauts modifiant le comportement suivants ont été appliqués rétroactivement aux normes C++ précédemment publiées.

1. ↑ erase() peut supprimer des éléments au milieu d'un vector , donc le type de valeur doit être MoveAssignable afin que les éléments suivant la section supprimée puissent être déplacés vers l'avant pour combler l'espace. Cependant, resize() ne peut supprimer que des éléments à la fin du vector , rendant MoveAssignable inutile.
2. ↑ Supprimer des éléments en utilisant pop_back() implique que les éléments doivent être supprimés de la fin vers le début.

Voir aussi