CKTIS / C++
std::vector::begin — begin van een vectorbereik
`begin()` geeft de beginiterator van de vector terug. De `const`-kwalificatie bepaalt de overload; `end()` markeert de positie die je niet mag derefereren.
Versie: ISO C++23; implementation support may vary
Syntax
// Public member declarations of std::vector<T, Allocator> in <vector> (ISO C++23)
constexpr iterator begin() noexcept;
constexpr const_iterator begin() const noexcept;std::vector::begin is een lidfunctie uit <vector>. De aanroep kost constante tijd, O(1), en levert bij een niet-lege vector een iterator naar het eerste element op. Beide overloads zijn noexcept sinds C++11 en constexpr sinds C++20. Ook in C++23 hangt constante evaluatie af van de context en de ondersteuning door de implementatie.
Bij een niet-const vector retourneert v.begin() een iterator waarmee je elementen kunt wijzigen. Bij toegang via const krijg je een const_iterator waarmee dat niet kan. Gebruik v.cbegin() (sinds C++11) om ook voor een wijzigbare vector een const_iterator te krijgen. Ga er niet van uit dat een iterator een ruwe pointer is of dat *it voor elke T een T& oplevert: een schrijfbare iterator van std::vector<bool> gebruikt een proxyobject.
Het halfopen bereik [v.begin(), v.end()) omvat de elementen van één vector, maar niet de positie voorbij het laatste element. Voor een lege vector geldt v.begin() == v.end(); het derefereren van een van beide iterators leidt tot ongedefinieerd gedrag. std::find_if retourneert het meegegeven eindpunt als niets voldoet. Controleer de uitkomst voordat je *it gebruikt.
Herallocatie maakt iterators, pointers en referenties naar elementen ongeldig, evenals een bewaarde end(). reserve() voegt geen elementen toe, maar kan heralloceren. Zonder herallocatie behoudt push_back() de iterators naar bestaande elementen, maar maakt het de oude end() ongeldig. Invoegen vooraan of het eerste element wissen kan een bewaarde begin() ook zonder herallocatie ongeldig maken. Vraag na ongeldigmaking nieuwe iterators op. Gebruik een iterator uit een tijdelijke vector niet voorbij de volledige expressie die de vector heeft aangemaakt.
Voorbeelden
#include <algorithm>
#include <iostream>
#include <vector>
int main() {
std::vector<int> values{2, 7, 4};
if (!values.empty()) {
*values.begin() = 3;
}
const auto& read = values;
const int threshold = 5;
const auto last = read.end();
const auto match = std::find_if(read.begin(), last, [threshold](int value) {
return value >= threshold;
});
if (read.cbegin() != read.cend()) {
std::cout << *read.cbegin() << '\n';
}
if (match != last) {
std::cout << *match << '\n';
}
const std::vector<int> empty;
if (empty.begin() == empty.end()) {
std::cout << "empty\n";
}
}Resultaat
3 7 empty
`*values.begin() = 3` wijzigt het eerste element. De zoekopdracht via een `const`-referentie gebruikt een op waarde vastgelegde drempel en leest de gevonden `7` pas na controle van het eindpunt. De iterators van de lege vector worden vergeleken zonder ze te derefereren.
Gerelateerde lessen
- C++ · Les 10 · Gevorderd · Versie: 3
- C++ · Les 11 · Gevorderd · Versie: 3
- C++ · Les 14 · Gevorderd · Versie: 3
- C++ · Les 15 · Gevorderd · Versie: 3
- C++ · Les 23 · 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 35 · Gevorderd · Versie: 3
- C++ · Les 40 · Gevorderd · Versie: 3
- C++ · Les 45 · Gevorderd · Versie: 3
- C++ · Les 57 · Gevorderd · Versie: 3
Bronnen
- WG21 N4950 — Working Draft, Standard for Programming Language C++
- C++ working draft — Class template vector [vector]
- C++ working draft — Container requirements [container.reqmts]
- C++ working draft — Vector capacity [vector.capacity]
- C++ working draft — Vector modifiers [vector.modifiers]
- C++ working draft — Specialization of vector for bool [vector.bool]
- C++ working draft — Find [alg.find]
- WG21 N4860 — C++ Draft International Standard