KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::basic_string::data — buffertoegang en schrijfgrenzen

Combineer `data()` met `size()` om ingebedde nultekens te behouden en let op de grenzen en levensduur van de string voordat je de pointer gebruikt.

Versie: 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 uit <string> geeft in constante tijd een pointer naar het aaneengesloten geheugen van de string, zonder gegevens te kopiëren of eigendom over te dragen. Een const-string kiest de overload die const CharT* teruggeeft; een niet-const-string kiest de sinds C++17 beschikbare overload met CharT*. Sinds C++11 is de const-overload noexcept en is nulterminatie gegarandeerd. De schrijfbare overload is vanaf de introductie noexcept; sinds C++20 zijn beide constexpr. Dit artikel beschrijft ISO C++23; de ondersteuning kan per implementatie verschillen.

De elementen staan in [s.data(), s.data() + s.size()). s.data()[s.size()] heeft de waarde CharT{} en telt niet mee voor size(); bij een lege string wijst de pointer naar dit afsluitende nulteken. c_str() geeft alleen-lezen toegang tot dezelfde buffer. Een functie voor C-strings zoals std::strlen voor char stopt bij het eerste nulteken, ook als dat midden in de string staat. std::basic_string_view::data() garandeert geen afsluitend nulteken aan het eind van de view.

Geef voor een exacte kopie een pointer en een aantal elementen door, bijvoorbeeld std::string(s.data(), s.size()) voor een std::string. Controleer voor een deelbereik vanaf pos eerst pos <= s.size() en daarna count <= s.size() - pos. size() telt CharT-elementen, geen Unicode-tekens: std::string gebruikt char, terwijl std::u8string (sinds C++20) char8_t gebruikt. Die pointer kun je dus niet rechtstreeks doorgeven aan een API die const char* verwacht.

Schrijf niet via de pointer van de const-overload. Overschrijf via CharT* alleen elementen met een index kleiner dan size(). Het afsluitende nulteken een andere waarde dan nul geven of via deze pointer voorbij dat teken gaan, leidt tot ongedefinieerd gedrag. reserve() vergroot size() niet; roep voor een groter schrijfbaar bereik resize() aan en haal daarna een nieuwe pointer op. Gebruik de pointer niet nadat de string is vernietigd, ook niet bij een tijdelijke string, of na een bewerking die de pointer ongeldig kan maken, zoals append().

Voorbeelden

#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';
}

Resultaat

3
1
C

De constructor met een expliciet aantal elementen behoudt het ingebedde nulteken. Schrijven via `data()` verandert het derde element in `C`, terwijl `std::strlen` nog steeds `1` teruggeeft.

Gerelateerde lessen

  • C++ · Les 49 · Gevorderd · Versie: 3
  • C++ · Les 58 · Gevorderd · Versie: 3

Bronnen