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
- 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]