CKTIS / C++
std::basic_string::data — accesso al buffer e limiti di scrittura
Usa `data()` insieme a `size()` per conservare gli zeri interni e controlla i limiti e la durata di vita della stringa prima di usare il puntatore.
Versione: ISO C++23; implementation support may vary
Sintassi
// <string>; members of std::basic_string<CharT, Traits, Allocator> in C++23
constexpr const CharT* data() const noexcept;
constexpr CharT* data() noexcept;std::basic_string::data, dichiarato in <string>, restituisce in tempo costante un puntatore alla memoria contigua della stringa, senza copiare i dati né trasferirne la proprietà. Una stringa const seleziona l’overload che restituisce const CharT*; una stringa non const seleziona quello che restituisce CharT*, introdotto in C++17. Da C++11 l’overload const è noexcept e il buffer è sempre terminato da uno zero. L’overload scrivibile è noexcept fin dalla sua introduzione; entrambi sono constexpr da C++20. Questa scheda descrive ISO C++23; il supporto può variare a seconda dell’implementazione.
Gli elementi della stringa occupano [s.data(), s.data() + s.size()). s.data()[s.size()] vale CharT{} e non rientra in size(); se la stringa è vuota, il puntatore punta proprio al terminatore. c_str() dà accesso in sola lettura allo stesso buffer. Una funzione per stringhe C come std::strlen per char si ferma al primo zero, anche se è interno alla stringa. std::basic_string_view::data() non garantisce un terminatore alla fine della vista.
Per una copia esatta, passa un puntatore e un numero di elementi, ad esempio std::string(s.data(), s.size()) per una std::string. Per un frammento che inizia in pos, verifica pos <= s.size() prima di count <= s.size() - pos. size() conta gli elementi CharT, non i caratteri Unicode: std::string usa char, mentre std::u8string (da C++20) usa char8_t, quindi il suo puntatore non può essere passato direttamente a un’API che si aspetta const char*.
Non scrivere tramite il puntatore dell’overload const. Tramite CharT*, sovrascrivi solo gli elementi con indice minore di size(). Impostare il terminatore a un valore diverso da zero o accedere oltre di esso tramite questo puntatore comporta un comportamento indefinito. reserve() non aumenta size(); per ampliare l’intervallo scrivibile, chiama resize() e poi ottieni di nuovo il puntatore. Non usarlo dopo la distruzione della stringa, anche se temporanea, né dopo un’operazione che può invalidarlo, come append().
Esempi
#include <cstring>
#include <iostream>
#include <string>
int main() {
const std::string input("A\0B", 3);
std::string copy(input.data(), input.size());
copy.data()[2] = 'C';
std::cout << copy.size() << '\n'
<< std::strlen(copy.c_str()) << '\n'
<< copy.data()[2] << '\n';
}
Risultato
3 1 C
Il costruttore con il numero di elementi conserva lo zero interno. La scrittura tramite `data()` imposta il terzo elemento a `C`, mentre `std::strlen` restituisce ancora `1`.
Lezioni correlate
- C++ · Lezione 49 · Avanzato · Versione: 3
- C++ · Lezione 58 · Avanzato · Versione: 3
Fonti
- C++ working draft — Accessors [string.accessors]
- C++ working draft — Class template basic_string: General [basic.string.general]
- C++ working draft — General requirements [string.require]
- C++ working draft — Constructors and assignment operators [string.cons]
- C++ working draft — Capacity [string.capacity]
- C++ working draft — String view element access [string.view.access]
- C++ working draft — Header <cstring> synopsis [cstring.syn]
- WG21 N4296 — C++ working draft, post-C++11 [string.accessors]
- WG21 N4713 — C++ working draft, post-C++17 [string.accessors]
- WG21 N4860 — C++20 Draft International Standard [string.accessors]