CKTIS / C++
std::basic_string::data — acesso ao buffer e limites de escrita
Usa `data()` com `size()` para preservar zeros internos e verifica os limites e o tempo de vida da cadeia antes de usares o ponteiro.
Versão: ISO C++23; implementation support may vary
Sintaxe
// <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, declarado em <string>, devolve em tempo constante um ponteiro para a memória contígua da cadeia, sem copiar os dados nem transferir a sua propriedade. Uma cadeia const seleciona a sobrecarga que devolve const CharT*; uma cadeia não const seleciona a que devolve CharT*, introduzida em C++17. Desde C++11, a sobrecarga const é noexcept e o buffer tem sempre um terminador zero. A sobrecarga que permite escrita é noexcept desde que foi introduzida; ambas são constexpr desde C++20. Esta entrada descreve ISO C++23; o suporte pode variar consoante a implementação.
Os elementos da cadeia ocupam [s.data(), s.data() + s.size()). s.data()[s.size()] tem o valor CharT{} e não conta para size(); se a cadeia estiver vazia, o ponteiro aponta para esse terminador. c_str() dá acesso de leitura ao mesmo buffer. Uma função para cadeias de C, como std::strlen para char, para no primeiro zero, mesmo que esteja dentro da cadeia. std::basic_string_view::data() não garante um terminador no fim da vista.
Para uma cópia exata, passa um ponteiro e um número de elementos, como em std::string(s.data(), s.size()) para uma std::string. Para um segmento que começa em pos, verifica pos <= s.size() antes de count <= s.size() - pos. size() conta elementos CharT, não carateres Unicode: std::string usa char, enquanto std::u8string (desde C++20) usa char8_t, pelo que o seu ponteiro não pode ser passado diretamente a uma API que espera const char*.
Não escrevas através do ponteiro da sobrecarga const. Através de CharT*, altera apenas elementos com índice inferior a size(). Dar ao terminador um valor diferente de zero ou aceder para além dele através deste ponteiro resulta em comportamento indefinido. reserve() não aumenta size(); para ampliar o intervalo em que podes escrever, chama resize() e volta a obter o ponteiro. Não o uses após a destruição da cadeia, mesmo que seja temporária, nem após uma operação que o possa invalidar, como append().
Exemplos
#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';
}
Resultado
3 1 C
O construtor que recebe o número de elementos preserva o zero interno. A escrita através de `data()` muda o terceiro elemento para `C`, enquanto `std::strlen` continua a devolver `1`.
Lições relacionadas
- C++ · Lição 49 · Avançado · Versão: 3
- C++ · Lição 58 · Avançado · Versão: 3
Fontes
- 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]