CKTIS / C++
std::transform — преобразуване на елементите в диапазон
std::transform от <algorithm> записва резултатите от унарна или бинарна операция в изходен диапазон. Не създава контейнер и не увеличава автоматично размера му.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#include <algorithm>
std::transform(first1, last1, result, op);
std::transform(first1, last1, first2, result, binary_op);std::transform от <algorithm> обработва полуотворения диапазон [first1, last1). Унарната форма прилага op към всеки елемент; бинарната форма прилага binary_op към съответстващите елементи от два диапазона. Записва резултатите, започвайки от result, и връща итератора след последния записан елемент.
За N елемента в първия диапазон операцията се извиква точно N пъти. Класическата бинарна форма не приема краен итератор за втория диапазон: той трябва да съдържа поне N достъпни елемента. Изходът също трябва да позволява N записа. Самото извикване на reserve() не създава елементи; за запис чрез begin() контейнерът трябва да е с подходящ размер.
Преобразуване на място е позволено, когато е изпълнено result == first1 или при бинарната форма — result == first2. Самата операция не трябва да променя елементи от обработваните диапазони или да инвалидира итератори. Не разчитайте на реда на извикванията ѝ; най-просто е да връщате резултат без странични ефекти.
Примерът показва и двете форми без политика за изпълнение. Този запис е за C++23; предоставеният проект на стандарта е развиващ се документ и съдържа и по-късни разширения, които примерът не използва.
Примери
#include <algorithm>
#include <array>
#include <iostream>
int main() {
const std::array<int, 3> input{1, 2, 3};
std::array<int, 3> squared{};
std::array<int, 3> sums{};
std::transform(input.begin(), input.end(), squared.begin(),
[](int x) { return x * x; });
std::transform(input.begin(), input.end(), squared.begin(), sums.begin(),
[](int x, int y) { return x + y; });
std::cout << squared[0] << ' ' << squared[1] << ' ' << squared[2] << '\n';
std::cout << sums[0] << ' ' << sums[1] << ' ' << sums[2] << '\n';
}
Резултат
1 4 9 2 6 12
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.