CKTIS / C++
std::ranges::transform — преобразуване на елементи към изход
std::ranges::transform изчислява стойности от един диапазон или от съответстващи елементи на два диапазона и ги записва чрез изходен итератор. Това е алгоритъм, който действа веднага, а не ленив изглед.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#include <algorithm>
std::ranges::transform(r, out, op);
std::ranges::transform(r, out, op, proj);
std::ranges::transform(first, last, out, op, proj);
std::ranges::transform(r1, r2, out, binary_op);
std::ranges::transform(r1, r2, out, binary_op, proj1, proj2);
std::ranges::transform(first1, last1, first2, last2, out, binary_op, proj1, proj2);std::ranges::transform от <algorithm> приема диапазони или двойки итератор–страж. Унарната форма преобразува всеки елемент; бинарната комбинира съответстващите елементи и спира при по-късия входен диапазон. Незадължителните проекции proj, proj1, proj2 се прилагат преди операцията; по подразбиране не променят аргументите.
Изходът трябва да позволява записването на всички резултати. Алгоритъмът не увеличава контейнер: само reserve() не създава елементи. Осигурете съществуващи елементи или използвайте std::back_inserter с подходящ контейнер. Преобразуване на място е разрешено, когато изходът започва от началото на някой вход. Самата операция не трябва да променя елементите на диапазоните или да обезсилва итератори.
Резултатът предоставя крайните позиции като .in и .out или като .in1, .in2 и .out. За временен диапазон, който не е borrowed range, входно поле може да бъде от тип std::ranges::dangling. При N записани резултата операцията и всяка проекция се извикват точно N пъти.
За разлика от ленивия изглед std::views::transform, този алгоритъм записва резултатите, преди да се върне. Тази статия описва употребата в C++23; текущият работен проект съдържа и по-късни разширения. Флаг за компилатора в хранилището не удостоверява съвместимостта на продукционната среда за изпълнение.
Примери
#include <algorithm>
#include <array>
#include <iostream>
int main() {
const std::array<int, 4> input{1, 2, 3, 4};
std::array<int, 4> output{};
auto result = std::ranges::transform(
input, output.begin(), [](int x) { return x * x; });
for (auto it = output.begin(); it != result.out; ++it) {
if (it != output.begin()) std::cout << ' ';
std::cout << *it;
}
std::cout << '\n';
}
Резултат
1 4 9 16
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.