CKTIS / C++
std::vector::empty — controleren of een vector leeg is
Gebruik `v.empty()` om in constante tijd te controleren of een vector geen elementen bevat. Gereserveerde capaciteit verandert de uitkomst niet.
Versie: ISO C++23; implementation support may vary
Syntax
constexpr bool empty() const noexcept;Neem <vector> op en roep v.empty() aan. std::vector::empty is een lidfunctie zonder argumenten: ze geeft true terug als de vector geen elementen bevat en anders false. De functie kost O(1) tijd, verandert de vector niet, werkt ook op een const-vector en werpt geen excepties (noexcept sinds C++11). Sinds C++20 is ze constexpr en kan ze worden gebruikt bij constante evaluatie als de volledige expressie aan de voorwaarden voldoet.
De uitkomst is gelijk aan die van v.size() == 0 en v.begin() == v.end(). Gebruik bij voorkeur v.empty() voor een ja-neevraag en v.size() als je het aantal elementen nodig hebt. std::empty(v) (sinds C++17, <iterator>) is een aparte vrije functie die voor een vector v.empty() aanroept.
Een geslaagde aanroep van v.reserve(n) garandeert een capaciteit van minstens n, maar maakt geen elementen aan. Een lege vector blijft dus leeg. push_back of emplace_back voegt een element toe; clear() vernietigt alle elementen zonder de capaciteit te wijzigen. Dezelfde regels gelden voor std::pmr::vector, die een andere allocator gebruikt.
Controleer !v.empty() voordat je v.back() of v.front() aanroept: beide aanroepen hebben op een lege vector ongedefinieerd gedrag in C++23. Derefereer v.end() nooit; in een lege vector is v.begin() gelijk aan v.end(). Ook in een niet-lege vector is niet elke index i geldig: voor v[i] moet de waarde van i na conversie naar het type size_type van de vector kleiner zijn dan v.size(). Een mediaanfunctie kan lege invoer expliciet afwijzen door std::invalid_argument uit <stdexcept> te werpen; empty() zelf werpt die exceptie niet.
Voorbeelden
#include <iostream>
#include <vector>
int main() {
std::vector<int> v;
v.reserve(8);
std::cout << std::boolalpha;
std::cout << "reserve: " << v.empty() << '\n';
v.push_back(42);
if (!v.empty()) {
std::cout << "back: " << v.back() << '\n';
}
v.clear();
std::cout << "clear: " << v.empty() << '\n';
}Resultaat
reserve: true back: 42 clear: true
`reserve(8)` laat de vector leeg. Na het toevoegen van `42` laat de controle de aanroep van `back()` toe; na `clear()` geeft `empty()` weer `true` terug.
Gerelateerde lessen
- C++ · Les 18 · Gevorderd · Versie: 3
- C++ · Les 23 · Gevorderd · Versie: 3
- C++ · Les 30 · Gevorderd · Versie: 3
Bronnen
- WG21 N4950 — Working Draft, Standard for Programming Language C++ (C++23)
- Class template vector — [vector.overview]
- Container requirements — [container.reqmts]
- Vector capacity — [vector.capacity]
- Sequence containers — [sequence.reqmts]
- Header <vector> synopsis — [vector.syn]
- Range access — [iterator.range]
- Class invalid_argument — [invalid.argument]