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

Ändert die Größe des Containers, um count Elemente zu enthalten:

• Wenn count gleich der aktuellen Größe ist, geschieht nichts.
• Wenn die aktuelle Größe größer als count ist, wird der Container auf seine ersten count Elemente reduziert.
• Wenn die aktuelle Größe kleiner als count ist, dann:

Parameter

Komplexität

Linear in der Differenz zwischen der aktuellen Größe und count . Zusätzliche Komplexität möglich aufgrund von Neuzuweisung, wenn die Kapazität kleiner ist als count .

Ausnahmen

Wenn aus irgendeinem Grund eine Exception ausgelöst wird, haben diese Funktionen keine Wirkung ( strong exception safety guarantee ). Obwohl nicht explizit spezifiziert, wird std::length_error ausgelöst, wenn die Kapazität, die der neue vector benötigen würde, max_size() überschreiten würde.

Hinweise

Wenn die Wertinitialisierung in Überladung ( 1 ) unerwünscht ist, zum Beispiel wenn die Elemente von Nicht-Klassen-Typ sind und das Nullsetzen nicht benötigt wird, kann dies vermieden werden, indem ein benutzerdefinierter Allocator::construct bereitgestellt wird.
Die Vektorkapazität wird bei der Verkleinerung niemals reduziert, da dies alle Iteratoren ungültig machen würde, während die Spezifikation nur die Iteratoren zu/nach den gelöschten Elementen ungültig macht.

Beispiel

#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

`-Tags wurden unverändert belassen
- C++-spezifische Begriffe wie "vector", "resize", "initializer" wurden nicht übersetzt
- Die Formatierung und Struktur der Webseite wurde vollständig beibehalten

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

1. ↑ erase() kann Elemente in der Mitte eines vector entfernen, daher muss der Werttyp MoveAssignable sein, damit die nachfolgenden Elemente nach vorne verschoben werden können, um die Lücke zu füllen. Allerdings kann resize() nur Elemente am Ende des vector entfernen, wodurch MoveAssignable unnötig wird.
2. ↑ Das Entfernen von Elementen mittels pop_back() impliziert, dass die Elemente von hinten nach vorne entfernt werden müssen.

Siehe auch