CKTIS / C++
std::basic_string::data — достъп до буфера и граници за запис
Използвай `data()` със `size()`, за да запазиш вградените нули, и проверявай границите и времето на живот на низа, преди да използваш указателя.
Версия: ISO C++23; implementation support may vary
Синтаксис
// <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 от заглавния файл <string> връща за константно време указател към непрекъснатата памет на низа, без да копира данните или да прехвърля собствеността върху тях. За низ const се избира вариантът, връщащ const CharT*, а за низ без const — вариантът, връщащ CharT*, въведен в C++17. От C++11 вариантът const е noexcept, а буферът гарантирано завършва с нулев елемент. Вариантът за запис е noexcept от въвеждането си; и двата са constexpr от C++20. Описанието е за ISO C++23; поддръжката може да зависи от реализацията.
Елементите на низа заемат диапазона [s.data(), s.data() + s.size()). Елементът s.data()[s.size()] има стойност CharT{} и не се брои от size(); при празен низ указателят сочи точно към този терминатор. c_str() дава достъп само за четене до същия буфер. Функция за низове в C като std::strlen за char спира при първата нула, дори да е вътре в низа. std::basic_string_view::data() не гарантира терминатор в края на изгледа.
За точно копие подай указател и брой елементи, например std::string(s.data(), s.size()) за низ от тип std::string. За отрязък с начало pos първо провери pos <= s.size(), а след това count <= s.size() - pos. size() брои елементи от тип CharT, а не символи на Unicode: std::string използва char, а std::u8string (от C++20) използва char8_t, затова указателят му не може да се подаде директно на API, което очаква const char*.
Не записвай през указателя от варианта const. През CharT* променяй само елементи с индекс, по-малък от size(). Задаването на ненулева стойност на терминатора или достъпът отвъд него през този указател води до неопределено поведение. reserve() не увеличава size(); за по-голям диапазон за запис извикай resize() и после вземи нов указател. Не го използвай след унищожаването на низа, включително ако е временен, или след операция, която може да направи указателя невалиден, като append().
Примери
#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';
}
Резултат
3 1 C
Конструкторът с брой елементи запазва вградената нула. Записът през `data()` променя третия елемент на `C`, а `std::strlen` продължава да връща `1`.
Свързани уроци
- C++ · Урок 49 · Напреднало · Версия: 3
- C++ · Урок 58 · Напреднало · Версия: 3
Източници
- 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]