CKTIS / C++
std::span — pohled na souvislé prvky
std::span zpřístupňuje souvislé prvky, aniž by je vlastnil. Umožňuje předat rozsah společně s jeho velikostí; subspan vytvoří pohled na jeho část bez kopírování prvků.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#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 pohled na souvislé prvky. Tyto prvky nevlastní ani neprodlužuje jejich životnost. Extent určuje pevnou velikost v typu; výchozí std::dynamic_extent, jako u std::span<T>, znamená, že se velikost určuje za běhu.
std::span::size() vrací počet prvků jako size_type, nikoli počet bajtů. std::span::subspan(offset, count) vytvoří bez kopírování dat pohled začínající na indexu offset. Pokud se count vynechá nebo se výslovně předá std::dynamic_extent, pohled zahrnuje zbytek rozsahu. Jinak zahrnuje count prvků. Toto přetížení vrací pohled s dynamickou velikostí. subspan<Offset, Count>() přijímá argumenty šablony. Pokud platí Count != std::dynamic_extent, má výsledek pevnou velikost Count. Pokud platí Count == std::dynamic_extent, ať už je tato hodnota zadána explicitně, nebo se použije jako výchozí, má výsledek dynamickou velikost, když Extent == std::dynamic_extent, jinak má pevnou velikost Extent - Offset.
V C++23 je vyžadováno offset <= size() a u explicitního count, který není std::dynamic_extent, také count <= size() - offset. Porušení těchto podmínek způsobuje nedefinované chování, nikoli zaručenou výjimku. Přetížení šablony navíc odmítá meze neslučitelné s rozsahem zakódovaným v typu. size() a subspan() mají konstantní časovou složitost.
Data musí zůstat platná po dobu používání pohledu; zničení vlastníka nebo realokace jeho úložiště může přístup zneplatnit. std::span<const T> brání změně prvků prostřednictvím pohledu, zatímco const std::span<T> tomu nebrání. Příklad mění původní pole prostřednictvím podhledu. Zdrojem je vyvíjející se návrh standardu, proto se tento popis záměrně omezuje na operace dostupné v C++23.
Pří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ýsledek
4 2 25 30
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.