CKTIS / C++
std::basic_string::reserve — capacità e dimensione
`reserve(n)` prepara spazio per elementi futuri senza cambiarne il numero. `resize(n)` cambia il numero di elementi sia nelle stringhe sia nei vettori.
Versione: ISO C++23; implementation support may vary
Sintassi
ISO C++23 member declarations (excerpts):
// <string>, in std::basic_string<CharT, Traits, Allocator>
constexpr void reserve(size_type n);
void reserve(); // Deprecated since C++20
constexpr void resize(size_type n);
constexpr void resize(size_type n, CharT c);
// <vector>, in std::vector<T, Allocator>
constexpr void reserve(size_type n);
constexpr void resize(size_type n);
constexpr void resize(size_type n, const T& value);std::basic_string::reserve è dichiarato in <string> e si può usare con std::string. In C++23, dopo una chiamata riuscita a s.reserve(n), vale capacity() >= n, mentre size() e il contenuto restano invariati. n è la capacità totale minima, non il numero di caratteri aggiuntivi. Se n <= capacity(), non avviene alcuna riallocazione e la capacità non cambia. Altrimenti lo spazio viene riallocato e la capacità può superare n.
std::vector::reserve(n), in <vector>, segue la stessa regola per la capacità senza creare elementi. La riallocazione invalida i puntatori, i riferimenti e gli iteratori esistenti agli elementi, compreso l’iteratore oltre l’ultimo elemento. Un vettore garantisce che gli inserimenti successivi non provochino riallocazioni finché un inserimento non farebbe superare la capacità. Non dare per scontata la stessa garanzia quando modifichi una stringa.
Usa resize(n) quando servono esattamente n elementi: riducendo la dimensione si eliminano gli elementi finali, aumentandola se ne aggiungono di nuovi. Gli overload s.resize(n, c) e v.resize(n, value) riempiono le nuove posizioni con il valore fornito. La capacità inutilizzata non estende l’intervallo degli indici degli elementi: scrivi in un elemento solo se i < size(). In una stringa, s[s.size()] indica il terminatore nullo, non un carattere aggiuntivo della stringa.
std::basic_string::reserve(n) lancia std::length_error se n > max_size() e può propagare un’eccezione dell’allocatore, come std::bad_alloc. In caso di eccezione, la stringa resta invariata. L’overload distinto s.reserve() senza argomenti è una richiesta non vincolante di riduzione della capacità, deprecata da C++20 ma ancora presente in C++23. Usa s.shrink_to_fit() per fare questa richiesta; la riduzione non è garantita.
Esempi
#include <iostream>
#include <string>
#include <vector>
int main() {
std::string s = "hi";
std::vector<int> v{1, 2};
s.reserve(64);
v.reserve(64);
std::cout << std::boolalpha;
std::cout << "string reserve: " << static_cast<unsigned int>(s.size()) << ' '
<< (s.capacity() >= 64) << ' ' << s << '\n';
std::cout << "vector reserve: " << static_cast<unsigned int>(v.size()) << ' '
<< (v.capacity() >= 64) << ' ' << v[0] << ' ' << v[1] << '\n';
s.resize(4, '!');
v.resize(4, 9);
std::cout << "string resize: " << static_cast<unsigned int>(s.size())
<< ' ' << s << '\n';
std::cout << "vector resize: " << static_cast<unsigned int>(v.size())
<< ' ' << v[2] << ' ' << v[3] << '\n';
}Risultato
string reserve: 2 true hi vector reserve: 2 true 1 2 string resize: 4 hi!! vector resize: 4 9 9
Dopo `reserve(64)`, entrambi i contenitori hanno ancora due elementi. Il programma controlla solo il limite inferiore della capacità; è `resize` ad aggiungere due elementi a ciascuno.
Lezioni correlate
- C++ · Lezione 5 · Avanzato · Versione: 3
Fonti
- C++23 working draft N4950 — [string.capacity], [string.require], [string.access], [vector.capacity], [depr.string.capacity]
- C++ working draft — Capacity [string.capacity]
- C++ working draft — Capacity [vector.capacity]
- C++ working draft — General requirements [string.require]
- P2870R0 — Remove basic_string::reserve() From C++26