(1) unary operation

Appliesop to each of the elements in the range[first1,last1) and stores the value returned by each operation in the range that begins atresult.

(2) binary operation

Callsbinary_op using each of the elements in the range[first1,last1) as first argument, and the respective argument in the range that begins atfirst2 as second argument. The value returned by each call is stored in the range that begins atresult.

1
2
3
4
5
6
7
8
9
10

template <class InputIterator,class OutputIterator,class UnaryOperator>  OutputIterator transform (InputIterator first1, InputIterator last1,                            OutputIterator result, UnaryOperator op){while (first1 != last1) {    *result = op(*first1);// or: *result=binary_op(*first1,*first2++);    ++result; ++first1;  }return result;}

Parameters

first1, last1

Input iterators to the initial and final positions of the first sequence. The range used is[first1,last1), which contains all the elements betweenfirst1 andlast1, including the element pointed to byfirst1 but not the element pointed to bylast1.

first2

Input iterator to the initial position of the second range. The range includes as many elements as[first1,last1).

result

Output iterator to the initial position of the range where the operation results are stored. The range includes as many elements as[first1,last1).

op

Unary function that accepts one element of the type pointed to byInputIterator as argument, and returns some result value convertible to the type pointed to byOutputIterator.
This can either be a function pointer or a function object.

binary_op

Binary function that accepts two elements as argument (one of each of the two sequences), and returns some result value convertible to the type pointed to byOutputIterator.
This can either be a function pointer or a function object.

Return value

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

// transform algorithm example#include <iostream>// std::cout#include <algorithm>// std::transform#include <vector>// std::vector#include <functional>// std::plusint op_increase (int i) {return ++i; }int main () {  std::vector<int> foo;  std::vector<int> bar;// set some values:for (int i=1; i<6; i++)    foo.push_back (i*10);// foo: 10 20 30 40 50  bar.resize(foo.size());// allocate space  std::transform (foo.begin(), foo.end(), bar.begin(), op_increase);// bar: 11 21 31 41 51// std::plus adds together its two arguments:  std::transform (foo.begin(), foo.end(), bar.begin(), foo.begin(), std::plus<int>());// foo: 21 41 61 81 101  std::cout <<"foo contains:";for (std::vector<int>::iterator it=foo.begin(); it!=foo.end(); ++it)    std::cout <<' ' << *it;  std::cout <<'\n';return 0;}

foo contains: 21 41 61 81 101

Complexity

Data races

Exceptions

See also

for_each

Apply function to range(function template)

copy

Copy range of elements(function template)