WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::vector::size — Anzahl der Elemente eines Vektors

`size()` liefert die aktuelle Elementanzahl in konstanter Zeit. Sie bestimmt die gültigen Indizes, nicht die mit `capacity()` abgefragte Kapazität.

Version: ISO C++23; implementation support may vary

Syntax

// Header: <vector>
// Member declaration inside std::vector<T, Allocator> (ISO C++23)
constexpr size_type size() const noexcept;

// Call on a vector v:
auto count = v.size();

std::vector::size ist eine parameterlose Memberfunktion aus <vector>. Sie gibt die Anzahl der Elemente in [v.begin(), v.end()) als Wert zurück (bei einem leeren Vektor null). Sie benötigt konstante Zeit, O(1), und ist auch für einen const-Vektor aufrufbar. Sie ist seit C++11 noexcept und seit C++20 constexpr und kann daher in einem konstanten Ausdruck verwendet werden, wenn die gesamte Auswertung dies zulässt. Hier gilt ISO C++23; die Unterstützung kann je nach Implementierung variieren.

capacity() gibt an, wie viele Elemente der Vektor ohne Neuzuweisung von Speicher aufnehmen kann. Ein erfolgreiches reserve(n) sichert Kapazität für mindestens n Elemente, erzeugt aber keine. resize(n) setzt die Elementanzahl auf n, ein erfolgreiches push_back erhöht sie um eins. Verwende v.empty(), wenn du nur prüfen willst, ob der Vektor leer ist.

Der Rückgabetyp size_type ist ein vorzeichenloser Ganzzahltyp, nicht zwingend std::size_t. Behalte ihn mit auto bei, statt ungeprüft in int umzuwandeln. Gültige Indizes erfüllen 0 <= i < v.size() in mathematischer Schreibweise; das ist keine C++-Bedingung. Weise vor der Umwandlung eines Index in size_type negative Werte und Werte oberhalb des Maximalwerts von size_type zurück. Andernfalls kann selbst ein nichtnegativer Wert eines breiteren Ganzzahltyps bei der Umwandlung einen anderen, zufällig gültigen Index ergeben. v[i] setzt einen gültigen Index voraus; v.at(i) prüft den Index nach der Umwandlung in size_type und löst std::out_of_range aus, wenn der umgewandelte Index größer oder gleich v.size() ist. Berechne v.size() - 1 nicht für einen leeren Vektor. Für eine Anzahl mit Vorzeichen verwende std::ssize(v) aus <iterator> (seit C++20).

Bei einem Vektor mit einem anderen Elementtyp als bool umfasst [v.data(), v.data() + v.size()) die vorhandenen Elemente; dereferenziere den Endzeiger nicht. std::vector<bool> zählt ebenfalls Elemente, stellt aber keinen solchen bool*-Puffer bereit. Eine gespeicherte Anzahl aktualisiert sich bei Änderungen am Vektor nicht. Eine Neuzuweisung des Speichers macht Zeiger, Referenzen und Iteratoren auf Elemente sowie das alte end() ungültig. Beim Anhängen wird das alte end() auch ohne Neuzuweisung ungültig.

Beispiele

#include <iostream>
#include <vector>

int main() {
    std::vector<int> v;
    const auto before = v.size();

    v.reserve(8);
    std::cout << "after reserve: " << v.size() << '\n';

    v.push_back(10);
    v.push_back(20);
    std::cout << "after append: " << v.size() << '\n';
    std::cout << "saved size: " << before << '\n';

    v.resize(1);
    std::cout << "after resize: " << v.size() << '\n';
}

Ergebnis

after reserve: 0
after append: 2
saved size: 0
after resize: 1

Nach `reserve(8)` ist der Vektor weiterhin leer. Zwei Aufrufe von `push_back` erhöhen die Größe auf 2, aber `before` bleibt 0. `resize(1)` entfernt das letzte Element. Das Programm setzt keine exakte Kapazität voraus.

Zugehörige Lektionen

  • C++ · Lektion 11 · Fortgeschritten · Version: 3
  • C++ · Lektion 14 · Fortgeschritten · Version: 3
  • C++ · Lektion 15 · Fortgeschritten · Version: 3
  • C++ · Lektion 18 · Fortgeschritten · Version: 3
  • C++ · Lektion 23 · Fortgeschritten · Version: 3
  • C++ · Lektion 24 · Fortgeschritten · Version: 3
  • C++ · Lektion 27 · Fortgeschritten · Version: 3
  • C++ · Lektion 29 · Fortgeschritten · Version: 3
  • C++ · Lektion 30 · Fortgeschritten · Version: 3
  • C++ · Lektion 32 · Fortgeschritten · Version: 3
  • C++ · Lektion 34 · Fortgeschritten · Version: 3
  • C++ · Lektion 51 · Fortgeschritten · Version: 3
  • C++ · Lektion 54 · Fortgeschritten · Version: 3
  • C++ · Lektion 57 · Fortgeschritten · Version: 3
  • C++ · Lektion 58 · Fortgeschritten · Version: 3
  • C++ · Lektion 59 · Fortgeschritten · Version: 3

Quellen