CKTIS / C++
`std::vector::data`: puntatore al buffer e limiti dell’intervallo
Ottieni un puntatore agli elementi del vettore, passalo insieme al numero di elementi e riconosci quando perde validità.
Versione: ISO C++23; implementation support may vary
Sintassi
#include <vector>
// Member declarations of std::vector<T, Allocator> (T != bool):
constexpr T* data() noexcept;
constexpr const T* data() const noexcept;std::vector::data, dichiarato in <vector>, restituisce in tempo costante un puntatore grezzo alla memoria contigua del vettore, senza copiare né trasferirne la proprietà. Se il vettore non è vuoto, restituisce l’indirizzo del primo elemento. Un vettore non const restituisce T*, che consente di modificare gli elementi esistenti; un vettore const restituisce const T*. Tramite const T* non puoi assegnare un nuovo valore all’elemento stesso, ma se T è un tipo classe puoi comunque modificare i membri dell’elemento dichiarati mutable. Entrambi gli overload sono noexcept e sono constexpr da C++20. La specializzazione std::vector<bool> non ha una funzione membro data() standard.
Se p = v.data() e n = v.size(), [p, p + n) è un intervallo semiaperto valido. Per un vettore non vuoto, p + n punta subito dopo l’ultimo elemento e non va mai dereferenziato. Se n == 0, p può essere nullptr oppure no, ma non è dereferenziabile in nessuno dei due casi. Controlla v.empty() o n == 0, anziché controllare se il puntatore è nullo.
Passa alla funzione che riceve il buffer il puntatore e il numero di elementi, oppure due puntatori che delimitano l’intervallo. size() conta gli elementi, non i byte; per char, i due conteggi coincidono. Un buffer std::vector<char> non ha un terminatore \0 automatico e un \0 interno non interrompe una lettura limitata dalla lunghezza. Se il buffer è vuoto, verifica che la funzione accetti un conteggio pari a zero e un puntatore eventualmente nullo. reserve() da solo non crea elementi: usa resize() prima di scrivere negli elementi aggiuntivi.
Non liberare la memoria tramite il puntatore e non usarlo dopo la distruzione del buffer. Una riallocazione invalida i puntatori agli elementi e il precedente limite di fine. push_back() può causare una riallocazione; anche se non la causa, un puntatore a un primo elemento già esistente resta valido, ma bisogna ricalcolare il limite di fine. Dopo una modifica strutturale del vettore, la soluzione più semplice è richiamare data() e size().
Esempi
#include <cstddef>
#include <iostream>
#include <vector>
void print_bytes(const char* first, std::size_t count) {
const char* last = first + count;
for (auto p = first; p != last; ++p) {
std::cout << (*p == '\0' ? '0' : *p) << ' ';
}
std::cout << '\n';
}
int main() {
std::vector<char> bytes{'A', '\0'};
bytes.push_back('B');
const auto& input = bytes;
print_bytes(input.data(), input.size());
}
Risultato
A 0 B
`print_bytes` calcola il puntatore subito dopo l’ultimo elemento ed elabora tutti e tre i byte. Mostra il `\0` interno come uno `0` visibile e `<<` inserisce uno spazio dopo ogni carattere, incluso `B`, prima del ritorno a capo.
Lezioni correlate
- C++ · Lezione 27 · Avanzato · Versione: 3
- C++ · Lezione 58 · Avanzato · Versione: 3
Fonti
- Draft C++ Standard — Data [vector.data]
- Draft C++ Standard — Class template vector overview [vector.overview]
- Draft C++ Standard — Capacity [vector.capacity]
- Draft C++ Standard — Modifiers [vector.modifiers]
- Draft C++ Standard — Specialization of vector for bool [vector.bool]
- Draft C++ Standard — Additive operators [expr.add]
- Draft C++ Standard — Character inserter function templates [ostream.inserters.character]
- WG21 SG10 — SD-6: Feature-Test Macros and Policies