Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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