CKTIS / C++
std::vector::empty — verificare se un vettore è vuoto
Usa `v.empty()` per verificare in tempo costante se un vettore non contiene elementi. La capacità riservata non incide sul risultato.
Versione: ISO C++23; implementation support may vary
Sintassi
constexpr bool empty() const noexcept;Includi <vector> e chiama v.empty(). std::vector::empty è una funzione membro senza argomenti: restituisce true se il vettore non contiene elementi e false altrimenti. Richiede tempo O(1), non modifica il vettore, può essere chiamata su un vettore const e non lancia eccezioni (noexcept da C++11). È constexpr da C++20 e può essere usata in una valutazione costante se l’intera espressione rispetta i requisiti.
Il risultato equivale a v.size() == 0 e a v.begin() == v.end(). Preferisci v.empty() quando ti basta una risposta sì o no; usa v.size() quando ti serve il numero di elementi. std::empty(v) (da C++17, <iterator>) è una funzione non membro distinta che per un vettore chiama v.empty().
Una chiamata riuscita a v.reserve(n) garantisce una capacità di almeno n senza creare elementi: un vettore vuoto resta vuoto. push_back o emplace_back aggiunge un elemento; clear() distrugge tutti gli elementi senza cambiare la capacità. Le stesse regole si applicano a std::pmr::vector, che usa un allocatore diverso.
Controlla !v.empty() prima di chiamare v.back() o v.front(): su un vettore vuoto entrambe le chiamate hanno comportamento indefinito in C++23. Non dereferenziare mai v.end(); in un vettore vuoto v.begin() coincide con v.end(). Un vettore non vuoto non rende valido qualsiasi indice i: per v[i], il valore di i dopo la conversione al tipo size_type del vettore deve essere minore di v.size(). Una funzione che calcola la mediana può rifiutare esplicitamente un input vuoto lanciando std::invalid_argument da <stdexcept>; empty() non lancia questa eccezione.
Esempi
#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';
}Risultato
reserve: true back: 42 clear: true
`reserve(8)` lascia vuoto il vettore. Dopo l’inserimento di `42`, il controllo consente di chiamare `back()`; dopo `clear()`, `empty()` restituisce di nuovo `true`.
Lezioni correlate
- C++ · Lezione 18 · Avanzato · Versione: 3
- C++ · Lezione 23 · Avanzato · Versione: 3
- C++ · Lezione 30 · Avanzato · Versione: 3
Fonti
- 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]