CKTIS / C++
std::span — pogled na uzastopne elemente
std::span omogućuje pristup uzastopnim elementima, a da ih ne posjeduje. Omogućuje prosljeđivanje raspona zajedno s njegovom veličinom, dok subspan stvara pogled na dio raspona bez kopiranja elemenata.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
#include <span>
// Default construction is allowed only for extent 0 or std::dynamic_extent.
std::span<T> empty; // Extent defaults to std::dynamic_extent.
std::span<T> view{data, count};
view.size();
view.subspan(offset, count);
view.subspan<Offset, Count>();std::span<T, Extent> iz <span> pogled je na uzastopne elemente. Ne posjeduje te elemente niti im produljuje životni vijek. Extent određuje fiksnu veličinu u tipu; zadana vrijednost std::dynamic_extent, kao u std::span<T>, znači da se veličina određuje tijekom izvođenja.
std::span::size() vraća broj elemenata kao size_type, a ne broj bajtova. std::span::subspan(offset, count) stvara pogled koji počinje na indeksu offset, bez kopiranja podataka. Ako se count izostavi ili se izričito proslijedi std::dynamic_extent, pogled obuhvaća ostatak raspona. U suprotnom obuhvaća count elemenata. Ovo preopterećenje vraća pogled dinamičke veličine. subspan<Offset, Count>() prima argumente predloška. Ako vrijedi Count != std::dynamic_extent, rezultat ima fiksnu veličinu Count. Ako vrijedi Count == std::dynamic_extent, bilo da je ta vrijednost izričito navedena ili se koristi kao zadana, veličina rezultata dinamička je kada vrijedi Extent == std::dynamic_extent; u suprotnom je fiksna i iznosi Extent - Offset.
U C++23 zahtijeva se offset <= size() te, za izričiti count koji nije std::dynamic_extent, i count <= size() - offset. Kršenje tih uvjeta uzrokuje nedefinirano ponašanje, a ne zajamčenu iznimku. Preopterećenje predloška dodatno odbacuje granice nespojive s opsegom kodiranim u tipu. size() i subspan() imaju konstantnu vremensku složenost.
Podaci moraju ostati valjani dok se pogled koristi; uništavanje vlasnika ili realokacija njegove pohrane može poništiti pristup. std::span<const T> sprječava mijenjanje elemenata putem pogleda, dok const std::span<T> to ne čini. Primjer mijenja izvorno polje putem podpogleda. Izvor je nacrt standarda koji se razvija pa se ovaj opis namjerno ograničava na operacije dostupne u C++23.
Primjeri
#include <iostream>
#include <span>
int main() {
int values[]{10, 20, 30, 40};
std::span<int> all{values};
auto middle = all.subspan(1, 2);
middle[0] = 25;
std::cout << all.size() << ' ' << middle.size() << '\n';
std::cout << values[1] << ' ' << middle[1] << '\n';
}
Rezultat
4 2 25 30
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.