CKTIS / C++
std::views::keys — eine Ansicht der ersten Elemente
std::views::keys erstellt eine verzögerte Ansicht der Elemente an Index 0 in einem Bereich aus Paaren oder Tupeln. So lassen sich Map-Schlüssel durchlaufen; der Adapter funktioniert aber auch mit anderen kompatiblen Bereichen, ohne eine separate Schlüsselsammlung anzulegen.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <ranges>
std::views::keys(range)
range | std::views::keysstd::views::keys aus <ranges> ist ein Range-Adapter, der std::views::elements<0> entspricht. range | std::views::keys bedeutet dasselbe wie std::views::keys(range). Der Adapter wählt aus jedem Element eines kompatiblen Bereichs aus Paaren oder Tupeln die Komponente an Index 0 aus; er ist nicht auf Maps beschränkt.
Die Ansicht arbeitet verzögert: Sie liefert die ausgewählte Komponente beim Dereferenzieren eines Iterators, statt eine Ergebnissammlung aufzubauen. Reihenfolge und Duplikate des zugrunde liegenden Bereichs bleiben erhalten — es wird weder sortiert noch dedupliziert. std::ranges::keys_view<R> ist ein Typalias für std::ranges::elements_view<R, 0>, nicht der Name des Adapters.
Bei einem Bereich, dessen Elemente Referenzen auf Paare sind, kann die Ansicht ebenfalls Referenzen liefern. Dann lässt sich die erste Komponente eines veränderbaren Paars ändern, während die Schlüssel von std::map konstant sind. Eine aus einem lvalue-Container erstellte Ansicht bezieht sich auf diesen Container: Er muss weiter existieren, und Operationen, die seine Iteratoren ungültig machen, können auch die Iteratoren der Ansicht ungültig machen.
Das Beispiel gibt 3, 1, 3 in getrennten Zeilen aus und zeigt damit, dass Reihenfolge und Duplikate erhalten bleiben. Der gezeigte Code wurde unverändert in einer isolierten Umgebung ausgeführt, und seine Standardausgabe stimmte exakt mit dem angegebenen Ergebnis überein. Zur lokalen Überprüfung dient die Option -std=c++23. Als Quelle dient der fortlaufend entwickelte Arbeitsentwurf, keine unveränderliche C++23-Veröffentlichung.
Beispiele
#include <array>
#include <iostream>
#include <ranges>
#include <utility>
int main() {
std::array<std::pair<int, int>, 3> entries{{
{3, 30}, {1, 10}, {3, 99}
}};
auto keys = entries | std::views::keys;
for (const auto& key : keys) {
std::cout << key << '\n';
}
}
Ergebnis
3 1 3
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.