KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::span — een view op aaneengesloten elementen

std::span geeft toegang tot aaneengesloten elementen zonder ze te bezitten. Je kunt er een bereik samen met de grootte mee doorgeven; subspan maakt een view op een deel van dat bereik zonder elementen te kopiëren.

Versie: 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> uit <span> is een view op aaneengesloten elementen. De view bezit die elementen niet en verlengt hun levensduur niet. Extent geeft een vaste grootte in het type aan; de standaardwaarde std::dynamic_extent, zoals bij std::span<T>, betekent dat de grootte tijdens runtime wordt bepaald.

std::span::size() geeft het aantal elementen terug als size_type, niet het aantal bytes. std::span::subspan(offset, count) maakt vanaf index offset een view zonder gegevens te kopiëren. Als je count weglaat of expliciet std::dynamic_extent meegeeft, omvat de view de rest van het bereik. Anders omvat de view count elementen. Deze overload geeft een view met dynamische grootte terug. subspan<Offset, Count>() neemt templateargumenten. Als Count != std::dynamic_extent, heeft het resultaat de vaste grootte Count. Als Count == std::dynamic_extent, ongeacht of die waarde expliciet is opgegeven of als standaardwaarde wordt gebruikt, heeft het resultaat een dynamische grootte wanneer Extent == std::dynamic_extent en anders de vaste grootte Extent - Offset.

In C++23 is offset <= size() vereist en, voor een expliciete count die niet std::dynamic_extent is, ook count <= size() - offset. Als niet aan deze voorwaarden wordt voldaan, is het gedrag ongedefinieerd. Er is geen garantie dat er een uitzondering wordt opgegooid. De template-overload wijst bovendien grenzen af die niet passen bij de extent die in het type is vastgelegd. size() en subspan() hebben constante tijdcomplexiteit.

De gegevens moeten geldig blijven zolang de view wordt gebruikt; vernietiging van de eigenaar of herallocatie van diens opslag kan toegang ongeldig maken. std::span<const T> voorkomt dat elementen via de view worden gewijzigd, terwijl const std::span<T> dat niet doet. Het voorbeeld wijzigt de oorspronkelijke array via een deelview. De bron is een evoluerend concept van de standaard; daarom beperkt deze beschrijving zich bewust tot bewerkingen die beschikbaar zijn in C++23.

Voorbeelden

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

Resultaat

4 2
25 30

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen