KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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