Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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