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
- Draft C++ Standard — Data [vector.data]
- Draft C++ Standard — Class template vector overview [vector.overview]
- Draft C++ Standard — Capacity [vector.capacity]
- Draft C++ Standard — Modifiers [vector.modifiers]
- Draft C++ Standard — Specialization of vector for bool [vector.bool]
- Draft C++ Standard — Additive operators [expr.add]
- Draft C++ Standard — Character inserter function templates [ostream.inserters.character]
- WG21 SG10 — SD-6: Feature-Test Macros and Policies