CKTIS / C++
std::basic_string::data — wskaźnik do danych i granice zapisu
Używaj `data()` razem z `size()`, aby zachować osadzone zera, i sprawdzaj granice oraz czas życia napisu przed użyciem wskaźnika.
Wersja: ISO C++23; implementation support may vary
Składnia
// <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 nagłówka <string> zwraca w stałym czasie wskaźnik do ciągłej pamięci napisu; nie kopiuje danych ani nie przekazuje własności. Dla obiektu const zwraca const CharT*, a dla obiektu bez const wybierane jest przeciążenie zwracające CharT*, dostępne od C++17. Od C++11 wersja const jest noexcept, a bufor ma gwarantowany terminator zerowy. Wersja zapisywalna jest noexcept od wprowadzenia; obie są constexpr od C++20. Opis dotyczy ISO C++23; obsługa może zależeć od implementacji.
Znaki napisu zajmują zakres [s.data(), s.data() + s.size()). s.data()[s.size()] ma wartość CharT{} i nie wlicza się do size(); dla pustego napisu wskaźnik wskazuje właśnie na ten terminator. c_str() udostępnia ten sam bufor tylko do odczytu. Funkcja C oczekująca napisu zakończonego zerem, taka jak std::strlen dla char, zatrzyma się na pierwszym zerze, nawet jeśli znajduje się ono wewnątrz napisu. std::basic_string_view::data() nie gwarantuje terminatora na końcu widoku.
Do wiernego kopiowania używaj wskaźnika i liczby elementów, np. std::string(s.data(), s.size()) dla std::string. Przed pobraniem fragmentu od pos sprawdź najpierw pos <= s.size(), a następnie count <= s.size() - pos. size() liczy elementy CharT, nie znaki Unicode: std::string używa char, a std::u8string (od C++20) używa char8_t, więc jego wskaźnika nie można bezpośrednio przekazać do API oczekującego const char*.
Nie zapisuj przez wskaźnik z przeciążenia const. Przez CharT* nadpisuj tylko elementy o indeksach mniejszych niż size(). Zmiana terminatora na wartość niezerową lub dostęp poza terminatorem przez ten wskaźnik ma niezdefiniowane zachowanie. reserve() nie zwiększa size(); przed zapisem do większego zakresu użyj resize(), a potem ponownie pobierz wskaźnik. Nie używaj go po zniszczeniu napisu, także tymczasowego, ani po operacji, która mogła go unieważnić, np. append().
Przykłady
#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';
}
Wynik
3 1 C
Konstruktor z liczbą elementów zachowuje osadzone zero. Zapis przez `data()` zmienia trzeci element na `C`, a `std::strlen` nadal zwraca `1`.
Powiązane lekcje
- C++ · Lekcja 49 · Zaawansowany · Wersja: 3
- C++ · Lekcja 58 · Zaawansowany · Wersja: 3
Źródła
- 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]