Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

std::span — pogled na zvezne elemente

std::span omogoča dostop do zveznih elementov, ne da bi jih imel v lasti. Omogoča posredovanje območja skupaj z njegovo velikostjo, subspan pa ustvari pogled na del območja brez kopiranja elementov.

Različica: 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> je pogled na zvezne elemente. Elementov ne poseduje in jim ne podaljša življenjske dobe. Extent določa fiksno velikost v tipu; privzeta vrednost std::dynamic_extent, kot pri std::span<T>, pomeni, da se velikost določi med izvajanjem.

std::span::size() vrne število elementov kot size_type, ne števila bajtov. std::span::subspan(offset, count) brez kopiranja podatkov ustvari pogled, ki se začne pri indeksu offset. Če je count izpuščen ali je izrecno podan std::dynamic_extent, pogled zajema preostanek območja. Sicer zajema count elementov. Ta preobremenitev vrne pogled z dinamično velikostjo. subspan<Offset, Count>() sprejme argumente predloge. Če velja Count != std::dynamic_extent, ima rezultat fiksno velikost Count. Če velja Count == std::dynamic_extent, ne glede na to, ali je ta vrednost navedena izrecno ali uporabljena kot privzeta, je velikost rezultata dinamična, kadar velja Extent == std::dynamic_extent; sicer je fiksna in znaša Extent - Offset.

V C++23 mora veljati offset <= size() in pri izrecnem count, ki ni std::dynamic_extent, tudi count <= size() - offset. Kršitev teh pogojev povzroči nedefinirano vedenje, ne pa zagotovljene izjeme. Preobremenitev predloge poleg tega zavrne meje, ki niso združljive z obsegom, kodiranim v tipu. size() in subspan() imata konstantno časovno zahtevnost.

Podatki morajo ostati veljavni, dokler se pogled uporablja; uničenje lastnika ali prerazporeditev njegovega pomnilnika lahko dostop razveljavi. std::span<const T> preprečuje spreminjanje elementov prek pogleda, const std::span<T> pa tega ne preprečuje. Primer spremeni izvirno polje prek podpogleda. Vir je razvijajoči se osnutek standarda, zato je opis namenoma omejen na operacije, ki so na voljo v C++23.

Primeri

#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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri