CKTIS / C++
`std::vector::data`: Pufferzeiger und Bereichsgrenzen
Rufe einen Zeiger auf die Elemente eines Vektors ab, übergib ihn mit der Elementanzahl und erkenne, wann er ungültig wird.
Version: ISO C++23; implementation support may vary
Syntax
#include <vector>
// Member declarations of std::vector<T, Allocator> (T != bool):
constexpr T* data() noexcept;
constexpr const T* data() const noexcept;std::vector::data aus <vector> liefert in konstanter Zeit einen rohen Zeiger in den zusammenhängenden Speicher des Vektors, ohne zu kopieren oder den Besitz zu übertragen. Bei einem nicht leeren Vektor ist es die Adresse des ersten Elements. Ein Vektor ohne const liefert T*, womit sich vorhandene Elemente ändern lassen; ein const-Vektor liefert const T*. Über const T* kannst du dem Element selbst keinen neuen Wert zuweisen. Ist T ein Klassentyp, kannst du über diesen Zeiger aber weiterhin die als mutable deklarierten Member des Elements ändern. Beide Überladungen sind noexcept und seit C++20 constexpr. Die Spezialisierung std::vector<bool> hat keine standardisierte Memberfunktion data().
Sind p = v.data() und n = v.size(), dann ist [p, p + n) ein gültiger halboffener Bereich. Bei einem nicht leeren Vektor zeigt p + n direkt hinter das letzte Element und darf nicht dereferenziert werden. Bei n == 0 kann p gleich nullptr sein oder nicht; in beiden Fällen darfst du ihn nicht dereferenzieren. Prüfe v.empty() oder n == 0, nicht ob der Zeiger null ist.
Übergib einer Funktion, die den Puffer verarbeitet, den Zeiger und die Elementanzahl oder zwei Zeiger als Bereichsgrenzen. size() zählt Elemente, nicht Bytes; bei char stimmen beide Anzahlen überein. Ein Puffer aus std::vector<char> hat kein automatisches Abschlusszeichen \0. Ein eingebettetes \0 beendet keinen Lesevorgang mit vorgegebener Länge. Prüfe bei einem leeren Puffer, ob die Funktion die Anzahl null und einen möglichen Nullzeiger akzeptiert. reserve() allein erzeugt keine Elemente: Verwende vor dem Schreiben in zusätzliche Elemente resize().
Gib den Speicher nicht über den Zeiger frei und nutze ihn nicht mehr, wenn der Puffer zerstört ist. Eine Reallokation macht Elementzeiger und die alte Bereichsgrenze ungültig. push_back() kann eine Reallokation auslösen. Auch ohne Reallokation bleibt ein Zeiger auf ein vorhandenes erstes Element zwar gültig, doch die Bereichsgrenze muss neu berechnet werden. Nach strukturellen Änderungen am Vektor rufst du am einfachsten data() und size() erneut auf.
Beispiele
#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());
}
Ergebnis
A 0 B
`print_bytes` berechnet den Zeiger unmittelbar hinter dem letzten Element und verarbeitet alle drei Bytes. Das eingebettete `\0` erscheint als sichtbare `0`. `<<` fügt nach jedem Zeichen ein Leerzeichen ein, auch nach `B`, bevor der Zeilenumbruch folgt.
Zugehörige Lektionen
- C++ · Lektion 27 · Fortgeschritten · Version: 3
- C++ · Lektion 58 · Fortgeschritten · Version: 3
Quellen
- 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