База знанияИзпитен център
BGБългарски
Избери език13

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

Източници