CKTIS / C++
std::basic_string::data — přístup k bufferu a meze zápisu
Používejte `data()` spolu se `size()`, aby se zachovaly vložené nuly, a před použitím ukazatele ověřte meze a dobu života řetězce.
Verze: ISO C++23; implementation support may vary
Syntaxe
// <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> vrací v konstantním čase ukazatel na souvislou paměť řetězce, aniž by data kopírovala nebo předávala jejich vlastnictví. U řetězce typu const se zvolí přetížení vracející const CharT*; u řetězce bez const se zvolí přetížení vracející CharT*, dostupné od C++17. Od C++11 je přetížení const označeno jako noexcept a buffer má zaručený nulový terminátor. Přetížení umožňující zápis je noexcept od zavedení; obě jsou constexpr od C++20. Popis platí pro ISO C++23; podpora se může lišit podle implementace.
Prvky řetězce leží v rozsahu [s.data(), s.data() + s.size()). s.data()[s.size()] má hodnotu CharT{} a nezapočítává se do size(); u prázdného řetězce ukazuje ukazatel právě na tento terminátor. c_str() poskytuje přístup ke stejnému bufferu pouze pro čtení. Funkce pro řetězce jazyka C, například std::strlen pro char, se zastaví na první nule, i když leží uvnitř řetězce. std::basic_string_view::data() nezaručuje terminátor na konci pohledu.
Pro přesnou kopii předejte ukazatel a počet prvků, u std::string například std::string(s.data(), s.size()). Pro úsek začínající na pos nejprve ověřte pos <= s.size() a pak count <= s.size() - pos. size() počítá prvky CharT, nikoli znaky Unicode: std::string používá char, zatímco std::u8string (od C++20) používá char8_t. Jeho ukazatel tedy nelze přímo předat rozhraní očekávajícímu const char*.
Nezapisujte přes ukazatel z přetížení const. Přes CharT* přepisujte jen prvky s indexem menším než size(). Nastavení terminátoru na nenulovou hodnotu nebo přístup za něj přes tento ukazatel vede k nedefinovanému chování. reserve() nezvětšuje size(); pro rozšíření zapisovatelného rozsahu zavolejte resize() a získejte nový ukazatel. Nepoužívejte ho po zániku řetězce, ani dočasného, nebo po operaci, která ho mohla zneplatnit, například append().
Pří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ýsledek
3 1 C
Konstruktor s počtem prvků zachová vloženou nulu. Zápis přes `data()` změní třetí prvek na `C`, zatímco `std::strlen` stále vrací `1`.
Související lekce
- C++ · Lekce 49 · Pokročilá · Verze: 3
- C++ · Lekce 58 · Pokročilá · Verze: 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]