CKTIS / C++
std::vector::begin — inizio dell’intervallo di un vettore
`begin()` restituisce l’iteratore iniziale del vettore. La qualificazione `const` determina l’overload e `end()` indica la posizione da non dereferenziare.
Versione: ISO C++23; implementation support may vary
Sintassi
// 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 è una funzione membro fornita da <vector>. Richiede tempo costante, O(1), e restituisce un iteratore al primo elemento se il vettore non è vuoto. Entrambi gli overload sono noexcept da C++11 e constexpr da C++20; in C++23 la valutazione costante dipende ancora dal contesto e dal supporto dell’implementazione.
Per un vettore non const, v.begin() restituisce un iterator che permette di modificare gli elementi. Se accedi al vettore tramite const, restituisce un const_iterator che non permette di modificarli. Usa v.cbegin() (da C++11) per ottenere un const_iterator anche da un vettore modificabile. Non dare per scontato che un iteratore sia un puntatore grezzo o che *it dia un T& per ogni T: un iteratore scrivibile di std::vector<bool> usa un oggetto proxy.
L’intervallo semiaperto [v.begin(), v.end()) comprende gli elementi dello stesso vettore ed esclude la posizione dopo l’ultimo elemento. Se il vettore è vuoto, v.begin() == v.end() e dereferenziare uno dei due iteratori causa comportamento indefinito. Se non ci sono corrispondenze, std::find_if restituisce il limite finale ricevuto; verifica il risultato prima di usare *it.
La riallocazione invalida iteratori, puntatori e riferimenti agli elementi, oltre a un end() salvato. reserve() non aggiunge elementi, ma può riallocare la memoria. Senza riallocazione, push_back() conserva gli iteratori agli elementi esistenti, ma invalida il vecchio end(). Inserire in testa o cancellare il primo elemento può invalidare un begin() salvato anche senza riallocazione. Ottieni nuovi iteratori dopo l’invalidazione. Non usare un iteratore di un vettore temporaneo oltre l’espressione completa che ha creato il vettore.
Esempi
#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";
}
}Risultato
3 7 empty
`*values.begin() = 3` modifica il primo elemento. La ricerca tramite un riferimento `const` usa una soglia catturata per valore e legge la corrispondenza `7` solo dopo aver controllato il limite finale. Gli iteratori del vettore vuoto vengono confrontati senza dereferenziarli.
Lezioni correlate
- C++ · Lezione 10 · Avanzato · Versione: 3
- C++ · Lezione 11 · Avanzato · Versione: 3
- C++ · Lezione 14 · Avanzato · Versione: 3
- C++ · Lezione 15 · Avanzato · Versione: 3
- C++ · Lezione 23 · Avanzato · Versione: 3
- C++ · Lezione 29 · Avanzato · Versione: 3
- C++ · Lezione 30 · Avanzato · Versione: 3
- C++ · Lezione 32 · Avanzato · Versione: 3
- C++ · Lezione 34 · Avanzato · Versione: 3
- C++ · Lezione 35 · Avanzato · Versione: 3
- C++ · Lezione 40 · Avanzato · Versione: 3
- C++ · Lezione 45 · Avanzato · Versione: 3
- C++ · Lezione 57 · Avanzato · Versione: 3
Fonti
- 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