Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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