CKTIS / C++
`std::vector::data` : pointeur sur le tampon et bornes de la plage
Obtenez un pointeur sur les éléments d’un vecteur, transmettez-le avec leur nombre et sachez quand ce pointeur cesse d’être valide.
Version : ISO C++23; implementation support may vary
Syntaxe
#include <vector>
// Member declarations of std::vector<T, Allocator> (T != bool):
constexpr T* data() noexcept;
constexpr const T* data() const noexcept;std::vector::data, déclaré dans <vector>, renvoie en temps constant un pointeur brut dans la zone de stockage contiguë du vecteur, sans copie ni transfert de propriété. Si le vecteur n’est pas vide, c’est l’adresse du premier élément. Un vecteur non const renvoie T*, qui permet de modifier les éléments existants ; un vecteur const renvoie const T*. Ce dernier ne permet pas d’affecter une nouvelle valeur à l’élément lui-même, mais si T est un type classe, il permet encore de modifier les membres de l’élément déclarés mutable. Les deux surcharges sont noexcept et sont constexpr depuis C++20. La spécialisation std::vector<bool> n’a pas de fonction membre data() standard.
Si p = v.data() et n = v.size(), [p, p + n) est une plage semi-ouverte valide. Pour un vecteur non vide, p + n pointe juste après le dernier élément ; il ne faut jamais le déréférencer. Si n == 0, p peut valoir nullptr ou non, mais il ne peut être déréférencé dans aucun des deux cas. Testez v.empty() ou n == 0, plutôt que de tester si le pointeur est nul.
À la fonction qui traite le tampon, transmettez le pointeur et le nombre d’éléments, ou deux pointeurs qui délimitent la plage. size() compte les éléments, non les octets ; pour char, ces nombres coïncident. Un tampon std::vector<char> ne comporte pas de terminateur \0 automatique, et un \0 interne ne met pas fin à une lecture bornée par la longueur. Si le tampon est vide, vérifiez que la fonction accepte un nombre nul et un pointeur éventuellement nul. reserve() seul ne crée pas d’éléments : utilisez resize() avant d’écrire dans des éléments supplémentaires.
Ne libérez pas la mémoire via ce pointeur et ne l’utilisez pas après la destruction du tampon. Une réallocation invalide les pointeurs sur les éléments ainsi que l’ancienne borne de fin. push_back() peut provoquer une réallocation ; même sans réallocation, un pointeur sur un premier élément existant reste valide, mais la borne de fin doit être recalculée. Après une modification structurelle du vecteur, le plus simple est de rappeler data() et size().
Exemples
#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());
}
Résultat
A 0 B
`print_bytes` calcule le pointeur juste après le dernier élément et traite les trois octets. La fonction affiche le `\0` interne sous la forme d’un `0` visible, et `<<` insère une espace après chaque caractère, y compris `B`, avant le saut de ligne.
Leçons associées
- C++ · Leçon 27 · Avancé · Version : 3
- C++ · Leçon 58 · Avancé · Version : 3
Sources
- 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