CKTIS / C++
std::basic_string::data — accès au tampon et limites d’écriture
Associez `data()` à `size()` pour conserver les zéros internes et vérifiez les limites et la durée de vie de la chaîne avant d’utiliser le pointeur.
Version : ISO C++23; implementation support may vary
Syntaxe
// <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, déclaré dans <string>, renvoie en temps constant un pointeur vers le stockage contigu de la chaîne, sans copie ni transfert de propriété. Une chaîne const sélectionne la surcharge qui renvoie const CharT* ; une chaîne non const sélectionne celle qui renvoie CharT*, ajoutée en C++17. Depuis C++11, la surcharge const est noexcept et le tampon se termine toujours par un zéro. La surcharge modifiable est noexcept depuis son introduction ; les deux sont constexpr depuis C++20. Cette fiche décrit ISO C++23 ; la prise en charge peut varier selon l’implémentation.
Les éléments de la chaîne occupent [s.data(), s.data() + s.size()). s.data()[s.size()] vaut CharT{} et n’est pas compté dans size() ; si la chaîne est vide, le pointeur désigne ce terminateur. c_str() donne un accès en lecture seule au même tampon. Une fonction pour chaînes C, comme std::strlen pour char, s’arrête au premier zéro, même s’il se trouve à l’intérieur de la chaîne. std::basic_string_view::data() ne garantit pas la présence d’un terminateur à la fin de la vue.
Pour une copie exacte, transmettez un pointeur et un nombre d’éléments, par exemple std::string(s.data(), s.size()) pour une std::string. Pour une sous-chaîne commençant à pos, vérifiez pos <= s.size() avant count <= s.size() - pos. size() compte les éléments CharT, pas les caractères Unicode : std::string utilise char, tandis que std::u8string (depuis C++20) utilise char8_t. Son pointeur ne peut donc pas être passé directement à une API qui attend const char*.
N’écrivez pas via le pointeur de la surcharge const. Via CharT*, ne modifiez que les éléments d’indice inférieur à size(). Remplacer le terminateur par une valeur non nulle ou accéder au-delà via ce pointeur entraîne un comportement indéfini. reserve() n’augmente pas size() ; pour agrandir la zone modifiable, appelez resize() puis récupérez un nouveau pointeur. N’utilisez plus le pointeur après la destruction de la chaîne, même temporaire, ni après une opération susceptible de l’invalider, comme append().
Exemples
#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';
}
Résultat
3 1 C
Le constructeur qui reçoit un nombre d’éléments conserve le zéro interne. L’écriture via `data()` remplace le troisième élément par `C`, alors que `std::strlen` renvoie toujours `1`.
Leçons associées
- C++ · Leçon 49 · Avancé · Version : 3
- C++ · Leçon 58 · Avancé · Version : 3
Sources
- 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]