CKTIS / C++
std::views::take — eine Ansicht der ersten Elemente eines Bereichs
std::views::take aus <ranges> erstellt eine Ansicht von höchstens count Anfangselementen eines Bereichs. Die Reihenfolge bleibt erhalten, es wird kein eigener Container erstellt, und sowohl ein direkter Aufruf als auch die Pipeline-Schreibweise sind möglich.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <ranges>
std::views::take(range, count)
range | std::views::take(count)std::views::take ist ein Bereichsadapterobjekt aus <ranges>. Der Ausdruck std::views::take(range, count) entspricht range | std::views::take(count). Ist count nichtnegativ und im Differenztyp der Iteratoren des Bereichs darstellbar, stellt das Ergebnis die ersten count Elemente in ihrer ursprünglichen Reihenfolge bereit oder den gesamten Bereich, falls dieser weniger Elemente enthält. Bei count gleich 0 ist das Ergebnis leer.
Dies ist eine Ansicht und kein kopierter Container: Durch die Anwendung des Adapters werden weder Elemente in eine neue Sammlung kopiert noch nachfolgende Elemente aus der Quelle entfernt. Die Elemente werden bei der Iteration gelesen. Das Ergebnis muss nicht den Typ std::ranges::take_view haben; für bestimmte Arten von Bereichen sieht der Standard andere gleichwertige Ansichtsrepräsentationen vor. Daher ist auto meist passend.
Das Argument count muss in den Differenztyp der Iteratoren des Bereichs konvertierbar sein. Verwenden Sie einen nichtnegativen Wert, der in diesem Typ darstellbar ist, auch wenn der Adapter keine std::ranges::take_view konstruiert. Im optimierten Fall für std::span konvertiert der Adapter beispielsweise count in diesen Typ, bevor er das Minimum aus dem konvertierten Wert und der Länge des Bereichs bestimmt. Ein zu großer Wert eines vorzeichenlosen Typs kann bei der Konvertierung zu -1 werden und zu ungültiger Iteratorarithmetik führen, statt den gesamten Bereich auszuwählen. Konstruiert der Adapter eine std::ranges::take_view, setzt der Konstruktor voraus, dass der konvertierte Wert nichtnegativ ist. Ein negativer Wert bedeutet nicht, dass vom Ende aus gezählt wird. Hat der Eingabebereich den Typ einer Spezialisierung von std::ranges::empty_view, wertet der Adapter das Argument count aus und verwirft seinen Wert, ohne eine std::ranges::take_view zu konstruieren. Ein negativer Wert verletzt diese Vorbedingung daher nicht.
Wird ein vorhandener Container über einen Lvalue adaptiert, verweist die Ansicht auf diesen Container. Die Quelle muss daher während der Nutzung der Ansicht weiter bestehen, und Operationen, die Iteratoren ungültig machen, können auch den Zugriff über die Ansicht ungültig machen. Im Beispiel wird die Änderung an values[0] nach dem Erstellen von first in der Ausgabe sichtbar: 11 20 30. Der gezeigte Code wurde unverändert in einer isolierten Umgebung ausgeführt. Seine Standardausgabe stimmte exakt mit der angegebenen Ausgabe überein.
Beispiele
#include <array>
#include <iostream>
#include <ranges>
int main() {
std::array<int, 5> values{10, 20, 30, 40, 50};
auto first = values | std::views::take(3);
values[0] = 11;
bool separator = false;
for (int value : first) {
if (separator) std::cout << ' ';
std::cout << value;
separator = true;
}
std::cout << '\n';
}
Ergebnis
11 20 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.