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

CKTIS / C++

`std::vector::data`: ponteiro para o buffer e limites do intervalo

Obtém um ponteiro para os elementos de um vetor, passa-o com o número de elementos e reconhece quando deixa de ser válido.

Versão: ISO C++23; implementation support may vary

Sintaxe

#include <vector>

// Member declarations of std::vector<T, Allocator> (T != bool):
constexpr T* data() noexcept;
constexpr const T* data() const noexcept;

std::vector::data, declarada em <vector>, devolve em tempo constante um ponteiro simples para a memória contígua do vetor, sem copiar nem transferir a propriedade. Se o vetor não estiver vazio, devolve o endereço do primeiro elemento. Um vetor não const devolve T*, que permite modificar elementos existentes; um vetor const devolve const T*. Através de const T* não podes atribuir um novo valor ao próprio elemento, mas, se T for um tipo de classe, podes modificar os membros do elemento declarados como mutable. Ambas as sobrecargas são noexcept e são constexpr desde C++20. A especialização std::vector<bool> não tem uma função membro data() normalizada.

Se p = v.data() e n = v.size(), [p, p + n) é um intervalo semiaberto válido. Num vetor não vazio, p + n aponta para a posição imediatamente a seguir ao último elemento e nunca deve ser desreferenciado. Se n == 0, p pode ou não ser nullptr, mas não pode ser desreferenciado em nenhum dos casos. Testa v.empty() ou n == 0, não se o ponteiro é nulo.

Passa à função que recebe o buffer o ponteiro e o número de elementos, ou dois ponteiros que delimitam o intervalo. size() conta elementos, não bytes; para char, as duas contagens coincidem. Um buffer std::vector<char> não tem um terminador \0 automático, e um \0 interno não termina uma leitura limitada pelo comprimento. Se o buffer estiver vazio, confirma que a função aceita uma contagem de zero e um ponteiro que pode ser nulo. reserve() por si só não cria elementos: usa resize() antes de escrever em elementos adicionais.

Não libertes a memória através do ponteiro nem o uses depois de o buffer ser destruído. Uma realocação invalida os ponteiros para os elementos e o limite final anterior. push_back() pode provocar uma realocação; mesmo sem ela, um ponteiro para um primeiro elemento existente continua válido, mas é preciso recalcular o limite final. Após alterações estruturais ao vetor, o mais simples é voltar a chamar data() e size().

Exemplos

#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());
}

Resultado

A 0 B 

`print_bytes` calcula o ponteiro para a posição a seguir ao último elemento e processa os três bytes. Apresenta o `\0` interno como um `0` visível, e `<<` insere um espaço depois de cada carácter, incluindo `B`, antes da mudança de linha.

Lições relacionadas

  • C++ · Lição 27 · Avançado · Versão: 3
  • C++ · Lição 58 · Avançado · Versão: 3

Fontes