Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

resize e reserve in std::vector e std::basic_string

`resize` modifica il numero di elementi presenti; `reserve` prepara spazio per elementi futuri senza modificare la dimensione o il contenuto.

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

Sintassi

// Selected ISO C++23 member declarations, grouped by owning class.
// std::vector<T, Allocator> — <vector>
constexpr void reserve(size_type n);
constexpr void resize(size_type n);
constexpr void resize(size_type n, const T& value);

// std::basic_string<CharT, Traits, Allocator> — <string>
constexpr void reserve(size_type n);
constexpr void resize(size_type n);
constexpr void resize(size_type n, CharT ch);

In C++23, std::vector e std::basic_string distinguono la dimensione (size()) dalla capacità (capacity()). reserve(n) non cambia né la dimensione né il contenuto. Se n > capacity(), lo spazio viene riallocato e la nuova capacità è almeno n; altrimenti rimane invariata. Lo spazio riservato non estende l’intervallo degli elementi accessibili. L’overload senza argomenti std::basic_string::reserve() è deprecato in C++23; std::vector non ha un overload equivalente.

Dopo una chiamata riuscita a resize(n) o resize(n, value), la dimensione è esattamente n. Ridurla elimina gli elementi finali; richiedere la dimensione corrente lascia intatto il contenuto. Quando la dimensione aumenta, std::vector::resize(n) aggiunge elementi inseriti per default secondo le regole dell’allocatore (zeri per std::vector<int> con il suo allocatore standard). L’overload a due argomenti aggiunge copie di value senza sostituire gli elementi esistenti.

Per std::basic_string, l’overload a un argomento aggiunge valori CharT() ('\0' per std::string), mentre quello a due argomenti aggiunge il carattere fornito. I caratteri nulli aggiunti contano per size(), ma le funzioni che si aspettano una stringa in stile C si fermano al primo carattere nullo. Nel testo UTF-8 std::string conta byte, non caratteri visibili; un troncamento può spezzare una sequenza multibyte.

La riallocazione di un vettore invalida tutti i puntatori, i riferimenti e gli iteratori ai suoi elementi, nonché il vecchio end(). Non usare quelli relativi a elementi rimossi. Per una stringa, resize può invalidarli anche se la capacità non cambia. Ridurre la dimensione non garantisce il rilascio della memoria. Per entrambi i tipi, reserve(n) lancia std::length_error se n > max_size(); lo stesso vale per resize(n) su una stringa. Anche l’allocazione o la costruzione degli elementi del vettore può lanciare eccezioni.

Esempi

#include <iostream>
#include <string>
#include <vector>

int main() {
    std::vector<int> v{10, 20};
    std::string s = "ab";

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

    v.resize(3);
    s.resize(3);
    std::cout << "default: " << v.back() << ' ' << (s.back() == '\0') << '\n';

    v.resize(5, 7);
    s.resize(5, '*');
    std::cout << "fill: " << v.back() << ' ' << s.back() << '\n';

    v.resize(1);
    s.resize(1);
    std::cout << "shrink: " << v.size() << ' ' << s.size()
              << " | " << v.front() << ' ' << s << '\n';
}

Risultato

reserve: 2 2
default: 0 1
fill: 7 *
shrink: 1 1 | 10 a

Dopo la riserva, entrambe le dimensioni sono ancora 2. Nella riga `default`, `1` indica che l’ultimo carattere è `'\0'`. Le righe successive mostrano il riempimento esplicito e la riduzione a un solo elemento.

Lezioni correlate

  • C++ · Lezione 5 · Avanzato · Versione: 3

Fonti