CKTIS / C++
std::basic_string::data — Pufferzugriff und Schreibgrenzen
Verwende `data()` zusammen mit `size()`, um eingebettete Nullzeichen zu erhalten. Beachte vor dem Zugriff die Grenzen und die Lebensdauer des Strings.
Version: ISO C++23; implementation support may vary
Syntax
// <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 aus <string> liefert in konstanter Zeit einen Zeiger auf den zusammenhängenden Speicher des Strings, ohne Daten zu kopieren oder Besitz zu übertragen. Bei einem const-String liefert die Überladung const CharT*; bei einem nicht konstanten String wird die seit C++17 verfügbare Überladung mit CharT* gewählt. Seit C++11 ist die konstante Überladung noexcept, und der Puffer ist garantiert nullterminiert. Die schreibbare Überladung ist seit ihrer Einführung noexcept; seit C++20 sind beide constexpr. Die Beschreibung gilt für ISO C++23; die Unterstützung kann je nach Implementierung variieren.
Die Elemente liegen in [s.data(), s.data() + s.size()). s.data()[s.size()] hat den Wert CharT{} und zählt nicht zu size(); bei einem leeren String zeigt der Zeiger auf dieses Abschlusszeichen. c_str() bietet lesenden Zugriff auf denselben Puffer. Eine C-String-Funktion wie std::strlen für char hält beim ersten Nullzeichen an, auch wenn es im String eingebettet ist. std::basic_string_view::data() garantiert kein Abschlusszeichen am Ende der Sicht.
Übergib für eine exakte Kopie einen Zeiger und eine Elementanzahl, bei std::string etwa std::string(s.data(), s.size()). Prüfe für einen Ausschnitt ab pos erst pos <= s.size() und dann count <= s.size() - pos. size() zählt CharT-Elemente, keine Unicode-Zeichen: std::string verwendet char, std::u8string (seit C++20) dagegen char8_t. Dessen Zeiger kann nicht direkt an eine API übergeben werden, die const char* erwartet.
Schreibe nicht über den Zeiger der konstanten Überladung. Überschreibe über CharT* nur Elemente mit einem Index kleiner als size(). Ein von null verschiedener Wert im Abschlusszeichen oder ein Zugriff dahinter über diesen Zeiger führt zu undefiniertem Verhalten. reserve() vergrößert size() nicht; rufe für einen größeren Schreibbereich resize() auf und hole danach einen neuen Zeiger. Verwende ihn nicht nach der Zerstörung des Strings, auch wenn dieser temporär ist, oder nach einer Operation, die ihn ungültig machen kann, etwa append().
Beispiele
#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';
}
Ergebnis
3 1 C
Der Konstruktor mit Elementanzahl erhält das eingebettete Nullzeichen. Der Schreibzugriff über `data()` setzt das dritte Element auf `C`; `std::strlen` liefert weiterhin `1`.
Zugehörige Lektionen
- C++ · Lektion 49 · Fortgeschritten · Version: 3
- C++ · Lektion 58 · Fortgeschritten · Version: 3
Quellen
- C++ working draft — Accessors [string.accessors]
- C++ working draft — Class template basic_string: General [basic.string.general]
- C++ working draft — General requirements [string.require]
- C++ working draft — Constructors and assignment operators [string.cons]
- C++ working draft — Capacity [string.capacity]
- C++ working draft — String view element access [string.view.access]
- C++ working draft — Header <cstring> synopsis [cstring.syn]
- WG21 N4296 — C++ working draft, post-C++11 [string.accessors]
- WG21 N4713 — C++ working draft, post-C++17 [string.accessors]
- WG21 N4860 — C++20 Draft International Standard [string.accessors]