WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::span — eine Sicht auf zusammenhängende Elemente

std::span ermöglicht den Zugriff auf zusammenhängende Elemente, ohne sie zu besitzen. So lässt sich ein Bereich zusammen mit seiner Größe übergeben; subspan erstellt eine Sicht auf einen Teil davon, ohne Elemente zu kopieren.

Version: 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> aus <span> ist eine Sicht auf zusammenhängende Elemente. Sie besitzt diese Elemente nicht und verlängert auch nicht deren Lebensdauer. Extent legt eine feste Größe im Typ fest; das Standardargument std::dynamic_extent, wie bei std::span<T>, bedeutet, dass die Größe zur Laufzeit bestimmt wird.

std::span::size() gibt die Anzahl der Elemente als size_type zurück, nicht die Anzahl der Bytes. std::span::subspan(offset, count) erstellt eine Sicht ab Index offset, ohne Daten zu kopieren. Wird count weggelassen oder explizit als std::dynamic_extent angegeben, umfasst die Sicht den restlichen Bereich. Andernfalls umfasst sie count Elemente. Diese Überladung liefert eine Sicht mit dynamischer Größe. subspan<Offset, Count>() nimmt Template-Argumente entgegen. Wenn Count != std::dynamic_extent gilt, hat das Ergebnis die feste Größe Count. Gilt Count == std::dynamic_extent, sei es durch explizite Angabe oder durch das Standardargument, ist die Größe des Ergebnisses bei Extent == std::dynamic_extent dynamisch und beträgt andernfalls fest Extent - Offset.

In C++23 muss offset <= size() gelten und bei einem expliziten count, das nicht std::dynamic_extent ist, außerdem count <= size() - offset. Werden diese Bedingungen verletzt, ist das Verhalten undefiniert; eine Ausnahme ist nicht garantiert. Die Template-Überladung weist zusätzlich Grenzen zurück, die mit der im Typ festgelegten Größe unvereinbar sind. size() und subspan() haben konstante Zeitkomplexität.

Die Daten müssen gültig bleiben, solange die Sicht verwendet wird; das Zerstören des Besitzers oder eine Reallokation seines Speichers kann den Zugriff ungültig machen. std::span<const T> verhindert Änderungen an Elementen über die Sicht, const std::span<T> dagegen nicht. Das Beispiel ändert das ursprüngliche Array über eine Teilsicht. Die Quelle ist ein sich weiterentwickelnder Standardentwurf; daher beschränkt sich diese Beschreibung bewusst auf in C++23 verfügbare Operationen.

Beispiele

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

Ergebnis

4 2
25 30

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen