Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori