CKTIS / C++
std::views::join — lazy ranges afvlakken
std::views::join maakt een lazy view van elementen uit een range van ranges. De view vlakt één niveau af, behoudt de volgorde en slaat lege binnenste ranges over zonder een nieuwe container te maken.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
#include <ranges>
std::views::join(r)
r | std::views::joinstd::views::join, gedeclareerd in <ranges>, is een range-adapter die een std::ranges::join_view maakt. r | std::views::join schrijven komt overeen met de aanroep std::views::join(r). De buitenste range en de binnenste ranges moeten ten minste sequentieel lezen ondersteunen zoals vereist door input_range.
De view vlakt precies één niveau af: hij bezoekt de elementen van opeenvolgende binnenste ranges en slaat lege ranges over. Hij voegt geen scheidingstekens in en maakt geen resultaatcontainer. In het voorbeeld drukt de lus de spaties af, niet de adapter.
Bij een container die als lvalue wordt doorgegeven, verwijst de view naar bestaande gegevens. De container moet blijven bestaan zolang de view wordt gebruikt; vermijd wijzigingen die iterators ongeldig maken. Als derefereren een veranderbare referentie oplevert, verandert schrijven via die referentie het bronelement.
Ga niet uit van willekeurige toegang of de beschikbaarheid van size(), ook niet wanneer de bron vectoren gebruikt. De mogelijkheden van de iterator hangen af van de ranges en van de manier waarop hun elementen beschikbaar worden gemaakt; join_view biedt hoogstens bidirectionele iteratie. Het aangehaalde werkdocument wordt bijgewerkt en is geen onveranderlijke C++23-specificatie.
Voorbeelden
#include <iostream>
#include <ranges>
#include <vector>
int main() {
std::vector<std::vector<int>> rows{{1, 2}, {}, {3, 4}};
auto flat = rows | std::views::join;
bool first = true;
for (int value : flat) {
if (!first) std::cout << ' ';
std::cout << value;
first = false;
}
std::cout << '\n';
}
Resultaat
1 2 3 4
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.