transform

Применяет объект заданной функции к каждому элементу в диапазон источника или в паре элементов из 2 диапазонов источника и копирует возвращаемые значения объекта функции в диапазон назначения.

template<class InputIterator, class OutputIterator, class UnaryFunction> 
   OutputIterator transform( 
      InputIterator _First1,  
      InputIterator _Last1,  
      OutputIterator _Result, 
      UnaryFunction _Func 
   ); 
template<class InputIterator1, class InputIterator2, class OutputIterator, 
   class BinaryFunction> 
   OutputIterator transform( 
      InputIterator1 _First1,  
      InputIterator1 _Last1, 
      InputIterator2 _First2,  
      OutputIterator _Result, 
      BinaryFunction _Func 
   );

Параметры

• _First1
  Итератор ввода слишком позицию первого элемента в первом используемом диапазоне источника.

• _Last1
  Итератор ввода слишком положение за одно окончательное элементом в первом диапазон источника работал включен.

• _First2
  Итератор ввода слишком позицию первого элемента в диапазоне второго источника эксплуатироваться на.

• _Result
  Итератор вывода слишком позицию первого элемента в диапазоне назначения.

• _Func
  Определяемый пользователем объект унарный функции, используемый в первой версии алгоритма, который применяется к каждому элементу в первом диапазон источника или объекта функции a определенного пользователем (UD) бинарном, используемых во второй версии алгоритма, который применяется pairwise, в порядке, на переднем 2 диапазонам источника.

Возвращаемое значение

Итератор вывода слишком положение за одно окончательное элементом в диапазоне назначения, который получает элементы вывода преобразовал объектом функции.

Заметки

Связанные диапазоны должны быть допустимыми; все указатели должны быть dereferenceable и внутри каждой последовательности последнего положения должна быть доступен из первого инкрементацией. Диапазон назначения должен быть достаточно большим содержать преобразованный диапазон источника.

Если _Result приравнивается к _First1 в первой версии алгоритма , диапазоны источника и назначения совпадали и последовательность будет изменена на месте. Но _Result не может выполнить позиция в диапазоне [_First1 +1, _Last1).

Сложность линейная с не более (_Last1 — _First1) сравнениями.

Пример

// alg_transform.cpp
// compile with: /EHsc
#include <vector>
#include <algorithm>
#include <functional>
#include <iostream>

// The function object multiplies an element by a Factor
template <class Type>
class MultValue
{
   private:
      Type Factor;   // The value to multiply by
   public:
      // Constructor initializes the value to multiply by
      MultValue ( const Type& _Val ) : Factor ( _Val ) {
      }

      // The function call for the element to be multiplied
      Type operator ( ) ( Type& elem ) const 
      {
         return elem * Factor;
      }
};

int main( )
{
   using namespace std;
   vector <int> v1, v2 ( 7 ), v3 ( 7 );
   vector <int>::iterator Iter1, Iter2 , Iter3;

   // Constructing vector v1
   int i;
   for ( i = -4 ; i <= 2 ; i++ )
   {
      v1.push_back(  i );
   }

   cout << "Original vector  v1 = ( " ;
   for ( Iter1 = v1.begin( ) ; Iter1 != v1.end( ) ; Iter1++ )
      cout << *Iter1 << " ";
   cout << ")." << endl;

   // Modifying the vector v1 in place
   transform (v1.begin ( ) , v1.end ( ) , v1.begin ( ) , MultValue<int> ( 2 ) );
   cout << "The elements of the vector v1 multiplied by 2 in place gives:"
        << "\n v1mod = ( " ;
   for ( Iter1 = v1.begin( ) ; Iter1 != v1.end( ) ; Iter1++ )
      cout << *Iter1 << " ";
   cout << ")." << endl;

   // Using transform to multiply each element by a factor of 5
   transform ( v1.begin ( ) , v1.end ( ) , v2.begin ( ) , MultValue<int> ( 5 ) );
   
   cout << "Multiplying the elements of the vector v1mod\n "
        <<  "by the factor 5 & copying to v2 gives:\n v2 = ( " ;
   for ( Iter2 = v2.begin( ) ; Iter2 != v2.end( ) ; Iter2++ )
      cout << *Iter2 << " ";
   cout << ")." << endl;

   // The second version of transform used to multiply the 
   // elements of the vectors v1mod & v2 pairwise
   transform ( v1.begin ( ) , v1.end ( ) ,  v2.begin ( ) , v3.begin ( ) , 
      multiplies <int> ( ) );
   
   cout << "Multiplying elements of the vectors v1mod and v2 pairwise "
        <<  "gives:\n v3 = ( " ;
   for ( Iter3 = v3.begin( ) ; Iter3 != v3.end( ) ; Iter3++ )
      cout << *Iter3 << " ";
   cout << ")." << endl;
}

Требования

Заголовок: <algorithm>

Пространство имен: std

См. также

Ссылки

Библиотека стандартных шаблонов