Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła