CKTIS / C++
std::views::take — een view van de eerste elementen van een bereik
std::views::take uit <ranges> maakt een view van maximaal count beginelementen van een bereik. De volgorde blijft behouden, er wordt geen aparte container gemaakt en zowel directe aanroepen als pipeline-notatie zijn mogelijk.
Versie: 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 is een bereikadapterobject uit <ranges>. De expressie std::views::take(range, count) komt overeen met range | std::views::take(count). Is count niet-negatief en past de waarde in het verschiltype van de iterators van het bereik, dan biedt het resultaat de eerste count elementen in hun oorspronkelijke volgorde, of het hele bereik als dat minder elementen bevat. Is count gelijk aan 0, dan is het resultaat leeg.
Dit is een view, geen gekopieerde container: door de adapter toe te passen worden elementen niet naar een nieuwe verzameling gekopieerd en worden er geen laatste elementen uit de bron verwijderd. Elementen worden tijdens het itereren gelezen. Het resultaat hoeft niet het type std::ranges::take_view te hebben; voor bepaalde soorten bereiken schrijft de standaard andere gelijkwaardige view-representaties voor. Daarom is auto meestal geschikt.
Het argument count moet converteerbaar zijn naar het verschiltype van de iterators van het bereik. Gebruik een niet-negatieve waarde die in dat type past, ook als de adapter geen std::ranges::take_view construeert. In het geoptimaliseerde geval voor std::span converteert de adapter bijvoorbeeld eerst count naar dat type en bepaalt hij daarna het minimum van de geconverteerde waarde en de lengte van het bereik. Een te grote waarde van een type zonder teken kan na conversie -1 worden en tot ongeldige iteratorrekenkunde leiden in plaats van het hele bereik te selecteren. Wanneer de adapter een std::ranges::take_view construeert, vereist de constructor dat de geconverteerde waarde niet-negatief is. Een negatieve waarde betekent niet dat vanaf het einde wordt geteld. Als het type van het invoerbereik een specialisatie van std::ranges::empty_view is, evalueert de adapter het argument count en gooit de waarde weg zonder een std::ranges::take_view te construeren. Een negatieve waarde schendt die voorwaarde dus niet.
Wanneer een bestaande container via een lvalue wordt aangepast, verwijst de view naar die container. De bron moet dus blijven bestaan zolang de view wordt gebruikt; bewerkingen die iterators ongeldig maken, kunnen ook toegang via de view ongeldig maken. In het voorbeeld is de wijziging van values[0] na het maken van first zichtbaar in de uitvoer: 11 20 30. De getoonde code is ongewijzigd uitgevoerd in een geïsoleerde omgeving. De standaarduitvoer kwam exact overeen met de opgegeven uitvoer.
Voorbeelden
#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';
}
Resultaat
11 20 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.