Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::vector::size — numero di elementi di un vettore

`size()` restituisce il numero attuale di elementi in tempo costante. È questo numero, non `capacity()`, a determinare gli indici validi.

Versione: ISO C++23; implementation support may vary

Sintassi

// Header: <vector>
// Member declaration inside std::vector<T, Allocator> (ISO C++23)
constexpr size_type size() const noexcept;

// Call on a vector v:
auto count = v.size();

std::vector::size è una funzione membro senza argomenti dichiarata in <vector>. Restituisce per valore il numero di elementi in [v.begin(), v.end()) (zero se il vettore è vuoto). Richiede tempo costante, O(1), e si può chiamare anche su un vettore const. È noexcept da C++11 e constexpr da C++20, quindi si può usare in un’espressione costante quando l’intera valutazione lo consente. La scheda descrive ISO C++23; il supporto può variare a seconda dell’implementazione.

capacity() indica quanti elementi il vettore può contenere senza riallocare la memoria. Se reserve(n) riesce, garantisce spazio per almeno n elementi, ma non ne crea nessuno. resize(n) porta il numero di elementi a n, mentre una chiamata riuscita a push_back lo aumenta di uno. Se vuoi solo sapere se il vettore è vuoto, usa v.empty().

Il tipo restituito, size_type, è un tipo intero senza segno, non necessariamente std::size_t. Mantienilo con auto anziché convertirlo in int senza controlli. Gli indici validi soddisfano 0 <= i < v.size() in notazione matematica; non è una condizione C++. Prima di convertire un indice in size_type, scarta i valori negativi e quelli superiori al massimo di quel tipo. Altrimenti anche un valore non negativo di un tipo intero più ampio può diventare, dopo la conversione, un indice diverso che rientra nei limiti. v[i] richiede un indice valido; v.at(i) controlla l’indice dopo la conversione in size_type e lancia std::out_of_range se l’indice convertito è maggiore o uguale a v.size(). Non calcolare v.size() - 1 per un vettore vuoto. Se serve un conteggio con segno, usa std::ssize(v) da <iterator> (da C++20).

Se il tipo degli elementi è diverso da bool, l’intervallo [v.data(), v.data() + v.size()) copre gli elementi esistenti; non dereferenziare il puntatore finale. Anche std::vector<bool> conta gli elementi, ma non espone un buffer bool* di quel tipo. Un conteggio salvato non si aggiorna quando il vettore cambia. La riallocazione invalida puntatori, riferimenti e iteratori agli elementi, oltre al vecchio end(). Un inserimento in coda invalida il vecchio end() anche senza riallocazione.

Esempi

#include <iostream>
#include <vector>

int main() {
    std::vector<int> v;
    const auto before = v.size();

    v.reserve(8);
    std::cout << "after reserve: " << v.size() << '\n';

    v.push_back(10);
    v.push_back(20);
    std::cout << "after append: " << v.size() << '\n';
    std::cout << "saved size: " << before << '\n';

    v.resize(1);
    std::cout << "after resize: " << v.size() << '\n';
}

Risultato

after reserve: 0
after append: 2
saved size: 0
after resize: 1

Dopo `reserve(8)` il vettore è ancora vuoto. Due chiamate a `push_back` portano la dimensione a 2, ma `before` resta 0. `resize(1)` rimuove l’ultimo elemento. Il programma non presume una capacità esatta.

Lezioni correlate

  • C++ · Lezione 11 · Avanzato · Versione: 3
  • C++ · Lezione 14 · Avanzato · Versione: 3
  • C++ · Lezione 15 · Avanzato · Versione: 3
  • C++ · Lezione 18 · Avanzato · Versione: 3
  • C++ · Lezione 23 · Avanzato · Versione: 3
  • C++ · Lezione 24 · Avanzato · Versione: 3
  • C++ · Lezione 27 · 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 51 · Avanzato · Versione: 3
  • C++ · Lezione 54 · Avanzato · Versione: 3
  • C++ · Lezione 57 · Avanzato · Versione: 3
  • C++ · Lezione 58 · Avanzato · Versione: 3
  • C++ · Lezione 59 · Avanzato · Versione: 3

Fonti