WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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