Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::basic_string::data — prístup k bufferu a hranice zápisu

Používajte `data()` spolu so `size()`, aby sa zachovali vložené nuly, a pred použitím ukazovateľa overte hranice a životnosť reťazca.

Verzia: 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 z hlavičky <string> vracia v konštantnom čase ukazovateľ na súvislú pamäť reťazca bez kopírovania dát alebo prenosu vlastníctva. Pri reťazci const sa vyberie preťaženie vracajúce const CharT*; pri reťazci bez const sa vyberie preťaženie vracajúce CharT*, dostupné od C++17. Od C++11 je preťaženie const označené ako noexcept a buffer má zaručený nulový terminátor. Preťaženie umožňujúce zápis je noexcept od zavedenia; obe sú constexpr od C++20. Opis platí pre ISO C++23; podpora sa môže líšiť podľa implementácie.

Prvky reťazca ležia v rozsahu [s.data(), s.data() + s.size()). s.data()[s.size()] má hodnotu CharT{} a nezapočítava sa do size(); pri prázdnom reťazci ukazovateľ ukazuje práve na tento terminátor. c_str() poskytuje prístup k rovnakému bufferu iba na čítanie. Funkcia pre reťazce jazyka C, napríklad std::strlen pre char, sa zastaví na prvej nule, aj keď je vnútri reťazca. std::basic_string_view::data() nezaručuje terminátor na konci pohľadu.

Na presné kopírovanie odovzdajte ukazovateľ a počet prvkov, pri std::string napríklad std::string(s.data(), s.size()). Pre úsek začínajúci na pos overte najskôr pos <= s.size() a potom count <= s.size() - pos. size() počíta prvky CharT, nie znaky Unicode: std::string používa char, zatiaľ čo std::u8string (od C++20) používa char8_t. Jeho ukazovateľ teda nemožno priamo odovzdať rozhraniu, ktoré očakáva const char*.

Nezapisujte cez ukazovateľ z preťaženia const. Cez CharT* prepisujte len prvky s indexom menším než size(). Nastavenie terminátora na nenulovú hodnotu alebo prístup zaň cez tento ukazovateľ vedie k nedefinovanému správaniu. reserve() nezväčšuje size(); ak potrebujete rozšíriť zapisovateľný rozsah, zavolajte resize() a získajte nový ukazovateľ. Nepoužívajte ho po zániku reťazca, ani dočasného, alebo po operácii, ktorá ho mohla zneplatniť, napríklad append().

Príklady

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

Výsledok

3
1
C

Konštruktor s počtom prvkov zachová vloženú nulu. Zápis cez `data()` zmení tretí prvok na `C`, zatiaľ čo `std::strlen` stále vracia `1`.

Súvisiace lekcie

  • C++ · Lekcia 49 · Pokročilá · Verzia: 3
  • C++ · Lekcia 58 · Pokročilá · Verzia: 3

Zdroje