CKTIS / C++
std::span — widok na ciągły obszar elementów
std::span udostępnia elementy leżące kolejno w pamięci bez przejmowania ich własności. Pozwala przekazywać zakres razem z jego rozmiarem, a subspan tworzy widok fragmentu bez kopiowania elementów.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#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 nagłówka <span> jest widokiem na elementy rozmieszczone kolejno w pamięci. Nie posiada tych elementów ani nie przedłuża ich życia. Extent określa stały rozmiar w typie; domyślne std::dynamic_extent, jak w std::span<T>, oznacza rozmiar ustalany podczas działania programu.
std::span::size() zwraca liczbę elementów jako size_type, nie liczbę bajtów. std::span::subspan(offset, count) tworzy widok zaczynający się od indeksu offset, bez kopiowania danych. Jeśli pominięto count lub jawnie przekazano std::dynamic_extent, widok obejmuje pozostałą część zakresu. W przeciwnym razie obejmuje count elementów. Ten wariant zwraca widok o dynamicznym rozmiarze. subspan<Offset, Count>() przyjmuje argumenty szablonu. Jeśli Count != std::dynamic_extent, rozmiar zapisany w typie wyniku to Count. Jeśli Count == std::dynamic_extent (niezależnie od tego, czy podano tę wartość jawnie, czy pominięto Count), wynik ma rozmiar dynamiczny, gdy Extent == std::dynamic_extent, a w przeciwnym razie ma stały rozmiar Extent - Offset.
W C++23 wymagane jest offset <= size() oraz, dla jawnego count innego niż std::dynamic_extent, count <= size() - offset. Naruszenie tych warunków powoduje niezdefiniowane zachowanie, a nie gwarantowany wyjątek. Wariant szablonowy dodatkowo odrzuca ograniczenia niezgodne z rozmiarem zapisanym w typie. size() i subspan() mają stałą złożoność czasową.
Dane muszą pozostawać ważne podczas używania widoku; zniszczenie właściciela lub realokacja jego pamięci może unieważnić dostęp. std::span<const T> blokuje modyfikację elementów przez widok, natomiast const std::span<T> tego nie robi. Przykład zmienia oryginalną tablicę przez podwidok. Źródłem jest rozwijany szkic standardu, więc opis celowo ogranicza się do operacji dostępnych w C++23.
Przykłady
#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';
}
Wynik
4 2 25 30
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.