Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::span — pohľad na súvislé prvky

std::span sprístupňuje súvislé prvky bez toho, aby ich vlastnil. Umožňuje odovzdať rozsah spolu s jeho veľkosťou; subspan vytvorí pohľad na jeho časť bez kopírovania prvkov.

Verzia: C++23; repository compiler flag, production runtime not attested

Syntax

#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> z <span> je pohľad na súvislé prvky. Tieto prvky nevlastní ani nepredlžuje ich životnosť. Extent určuje pevnú veľkosť v type; predvolená hodnota std::dynamic_extent, ako pri std::span<T>, znamená, že veľkosť sa určuje za behu.

std::span::size() vracia počet prvkov ako size_type, nie počet bajtov. std::span::subspan(offset, count) vytvorí bez kopírovania dát pohľad začínajúci na indexe offset. Ak sa count vynechá alebo sa explicitne odovzdá std::dynamic_extent, pohľad zahŕňa zvyšok rozsahu. Inak zahŕňa count prvkov. Toto preťaženie vracia pohľad s dynamickou veľkosťou. subspan<Offset, Count>() prijíma argumenty šablóny. Ak platí Count != std::dynamic_extent, výsledok má pevnú veľkosť Count. Ak platí Count == std::dynamic_extent, či už je táto hodnota zadaná explicitne, alebo sa použije ako predvolená, výsledok má dynamickú veľkosť, keď Extent == std::dynamic_extent, inak má pevnú veľkosť Extent - Offset.

V C++23 sa vyžaduje offset <= size() a pri explicitnom count, ktorý nie je std::dynamic_extent, aj count <= size() - offset. Porušenie týchto podmienok spôsobuje nedefinované správanie, nie zaručenú výnimku. Preťaženie šablóny navyše odmieta hranice nezlučiteľné s rozsahom zakódovaným v type. size() a subspan() majú konštantnú časovú zložitosť.

Dáta musia zostať platné počas používania pohľadu; zničenie vlastníka alebo realokácia jeho úložiska môže zneplatniť prístup. std::span<const T> bráni zmene prvkov cez pohľad, zatiaľ čo const std::span<T> tomu nebráni. Príklad mení pôvodné pole prostredníctvom podhľadu. Zdrojom je vyvíjajúci sa návrh štandardu, preto sa tento opis zámerne obmedzuje na operácie dostupné v C++23.

Príklady

#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';
}

Výsledok

4 2
25 30

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje