CKTIS / C++
std::views::transform — líná transformace rozsahu
std::views::transform vytváří pohled, který vypočítá výsledek funkce pro prvek až při přístupu k němu. Nevytváří výsledný kontejner; lze jej použít přímo nebo v řetězci operací s operátorem |.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <ranges>
std::views::transform(range, callable)
range | std::views::transform(callable)std::views::transform, deklarovaný v <ranges>, je adaptér rozsahu, který vytváří std::ranges::transform_view. Zápisy std::views::transform(range, callable) i range | std::views::transform(callable) zpřístupňují transformované prvky v pořadí zdroje, aniž by je filtrovaly.
Vyhodnocování je líné: funkce se volá při dereferencování iterátoru, nikoli při vytvoření pohledu. Výsledky se neukládají do mezipaměti, takže opakovaný přístup může funkci zavolat znovu. Samotný pohled nevytváří výsledný kontejner ani automaticky nepřepisuje zdroj. Funkce však může vracet odkaz místo hodnoty.
Funkce musí pro referenci na prvek splňovat regular_invocable: ekvivalentní argumenty by měly dávat ekvivalentní výsledky, aniž by se měnily argumenty nebo vlastní stav funkčního objektu. Výsledek nesmí mít typ void. Jako transformační funkce se proto vyhýbejte počítadlům volání a mutujícím lambdám.
U kontejneru předaného jako lvalue se pohled na tento kontejner odkazuje: kontejner musí zůstat živý po celou dobu používání pohledu. Platné musí zůstat také odkazy zachycené funkcí. Iterátor navíc závisí na objektu pohledu; po zničení pohledu si jej neponechávejte.
Příklad mění numbers[0] až po vytvoření doubled. Výsledek 8 4 6 ukazuje, že pohled čte aktuální prvky místo uložení dříve vypočtené kopie. Použijte režim kompilace -std=c++23; dodané zdroje jsou průběžně se vyvíjejícím návrhem standardu, nikoli neměnným textem C++23.
Příklady
#include <array>
#include <iostream>
#include <ranges>
int main() {
std::array<int, 3> numbers{1, 2, 3};
auto doubled = numbers | std::views::transform([](int n) {
return n * 2;
});
numbers[0] = 4;
bool first = true;
for (int value : doubled) {
if (!first) std::cout << ' ';
std::cout << value;
first = false;
}
std::cout << '\n';
}
Výsledek
8 4 6
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.