CKTIS / C++
`std::vector::data`: kazalec na medpomnilnik in meje obsega
Pridobi kazalec na elemente vektorja, ga podaj skupaj s številom elementov in prepoznaj, kdaj kazalec ni več veljaven.
Različica: ISO C++23; implementation support may vary
Sintaksa
#include <vector>
// Member declarations of std::vector<T, Allocator> (T != bool):
constexpr T* data() noexcept;
constexpr const T* data() const noexcept;std::vector::data iz glave <vector> v konstantnem času vrne surovi kazalec v zvezno pomnilniško območje vektorja, brez kopiranja ali prenosa lastništva. Pri nepraznem vektorju vrne naslov prvega elementa. Vektor brez const vrne T*, prek katerega lahko spreminjaš obstoječe elemente; vektor const vrne const T*. Prek const T* elementu samemu ne moreš prirediti nove vrednosti, če pa je T razredni tip, lahko prek tega kazalca še vedno spreminjaš podatkovne člane elementa, deklarirane kot mutable. Obe preobremenitvi sta noexcept, od C++20 pa tudi constexpr. Specializacija std::vector<bool> nima standardne članske funkcije data().
Če velja p = v.data() in n = v.size(), je [p, p + n) veljaven polodprt obseg. Pri nepraznem vektorju p + n kaže tik za zadnjim elementom in ga ne smeš dereferencirati. Če je n == 0, je p lahko nullptr ali pa ne, vendar ga v nobenem primeru ne smeš dereferencirati. Preveri v.empty() ali n == 0, ne pa, ali je kazalec ničeln.
Funkciji, ki prejme medpomnilnik, podaj kazalec in število elementov ali par kazalcev, ki omejujeta obseg. size() šteje elemente, ne bajtov; pri char se števili ujemata. Medpomnilnik std::vector<char> nima samodejnega zaključnega znaka \0, notranji \0 pa ne konča branja, omejenega z dolžino. Pri praznem medpomnilniku preveri, ali funkcija sprejme nič elementov in morebiten ničelni kazalec. Sam reserve() ne ustvari elementov: pred pisanjem v dodatne elemente uporabi resize().
Ne sproščaj pomnilnika prek kazalca in ga ne uporabljaj po uničenju medpomnilnika. Ponovna dodelitev pomnilnika razveljavi kazalce na elemente in prejšnjo končno mejo obsega. push_back() lahko sproži ponovno dodelitev; tudi če je ne, kazalec na obstoječi prvi element ostane veljaven, končno mejo pa je treba izračunati znova. Po strukturnih spremembah vektorja je najpreprosteje znova poklicati data() in size().
Primeri
#include <cstddef>
#include <iostream>
#include <vector>
void print_bytes(const char* first, std::size_t count) {
const char* last = first + count;
for (auto p = first; p != last; ++p) {
std::cout << (*p == '\0' ? '0' : *p) << ' ';
}
std::cout << '\n';
}
int main() {
std::vector<char> bytes{'A', '\0'};
bytes.push_back('B');
const auto& input = bytes;
print_bytes(input.data(), input.size());
}
Rezultat
A 0 B
`print_bytes` izračuna kazalec tik za zadnjim elementom in obdela vse tri bajte. Notranji `\0` prikaže kot vidno `0`, `<<` pa vstavi presledek za vsakim znakom, tudi za `B`, pred prehodom v novo vrstico.
Povezane lekcije
- C++ · Lekcija 27 · Napredna · Različica: 3
- C++ · Lekcija 58 · Napredna · Različica: 3
Viri
- Draft C++ Standard — Data [vector.data]
- Draft C++ Standard — Class template vector overview [vector.overview]
- Draft C++ Standard — Capacity [vector.capacity]
- Draft C++ Standard — Modifiers [vector.modifiers]
- Draft C++ Standard — Specialization of vector for bool [vector.bool]
- Draft C++ Standard — Additive operators [expr.add]
- Draft C++ Standard — Character inserter function templates [ostream.inserters.character]
- WG21 SG10 — SD-6: Feature-Test Macros and Policies