CKTIS / C++
std::vector::size — aantal elementen in een vector
`size()` geeft het huidige aantal elementen in constante tijd terug. Dat aantal bepaalt welke indices geldig zijn, niet `capacity()`.
Versie: 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 is een lidfunctie zonder argumenten, gedeclareerd in <vector>. De functie geeft het aantal elementen in [v.begin(), v.end()) als waarde terug (nul voor een lege vector). De looptijd is constant, O(1), en je kunt de functie op een const-vector aanroepen. Ze is noexcept sinds C++11 en constexpr sinds C++20, dus je kunt haar in een constante expressie gebruiken als de volledige evaluatie dat toelaat. Deze tekst beschrijft ISO C++23; de ondersteuning kan per implementatie verschillen.
capacity() geeft aan hoeveel elementen de vector kan bevatten zonder opnieuw geheugen toe te wijzen. Een geslaagde aanroep van reserve(n) garandeert capaciteit voor minstens n elementen, maar maakt er geen aan. resize(n) stelt het aantal elementen in op n; een geslaagde aanroep van push_back verhoogt dat aantal met één. Gebruik v.empty() als je alleen wilt weten of de vector leeg is.
Het retourtype size_type is een geheel getaltype zonder teken, niet per se std::size_t. Behoud het met auto in plaats van het zonder controle naar int om te zetten. Geldige indices voldoen in wiskundige notatie aan 0 <= i < v.size(); dit is geen C++-voorwaarde. Wijs negatieve waarden en waarden boven het maximum van size_type af voordat je een index naar size_type omzet. Anders kan zelfs een niet-negatieve waarde van een breder geheel getaltype na omzetting een andere index opleveren die binnen het bereik valt. v[i] vereist een geldige index; v.at(i) controleert de index na omzetting naar size_type en gooit std::out_of_range als de omgezette index groter dan of gelijk aan v.size() is. Bereken v.size() - 1 niet voor een lege vector. Heb je een aantal met teken nodig, gebruik dan std::ssize(v) uit <iterator> (sinds C++20).
Bij een elementtype anders dan bool omvat [v.data(), v.data() + v.size()) de bestaande elementen; derefereer de eindpointer niet. std::vector<bool> telt ook elementen, maar stelt geen dergelijke bool*-buffer beschikbaar. Een opgeslagen aantal verandert niet mee met de vector. Als er opnieuw geheugen wordt toegewezen, worden pointers, referenties en iterators naar elementen ongeldig, evenals de oude end(). Achteraan toevoegen maakt de oude end() ook ongeldig als er geen nieuw geheugen wordt toegewezen.
Voorbeelden
#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';
}
Resultaat
after reserve: 0 after append: 2 saved size: 0 after resize: 1
Na `reserve(8)` is de vector nog leeg. Twee aanroepen van `push_back` brengen de grootte op 2, maar `before` blijft 0. `resize(1)` verwijdert het laatste element. Het programma gaat niet uit van een exacte capaciteit.
Gerelateerde lessen
- C++ · Les 11 · Gevorderd · Versie: 3
- C++ · Les 14 · Gevorderd · Versie: 3
- C++ · Les 15 · Gevorderd · Versie: 3
- C++ · Les 18 · Gevorderd · Versie: 3
- C++ · Les 23 · Gevorderd · Versie: 3
- C++ · Les 24 · Gevorderd · Versie: 3
- C++ · Les 27 · Gevorderd · Versie: 3
- C++ · Les 29 · Gevorderd · Versie: 3
- C++ · Les 30 · Gevorderd · Versie: 3
- C++ · Les 32 · Gevorderd · Versie: 3
- C++ · Les 34 · Gevorderd · Versie: 3
- C++ · Les 51 · Gevorderd · Versie: 3
- C++ · Les 54 · Gevorderd · Versie: 3
- C++ · Les 57 · Gevorderd · Versie: 3
- C++ · Les 58 · Gevorderd · Versie: 3
- C++ · Les 59 · Gevorderd · Versie: 3
Bronnen
- C++ working draft — Class template vector [vector]
- C++ working draft — Container requirements [container.reqmts]
- C++ working draft — Sequence containers [sequence.reqmts]
- C++ working draft — Vector capacity [vector.capacity]
- C++ working draft — Vector data [vector.data]
- C++ working draft — Vector modifiers [vector.modifiers]
- C++ working draft — Specialization of vector for bool [vector.bool]
- C++ working draft — Range access [iterator.range]