transform

Function 개체의 반환 값을 대상 범위로 복사 및 각 원본 범위에 요소 또는 요소 쌍 두 원본 범위에서 지정 된 함수 개체를 적용 합니다.

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
  각 원본 범위의 첫 번째 요소에 적용 되는 알고리즘의 첫 번째 버전에 사용 되는 사용자 정의 된 단항 함수 개체 또는 사용자 정의 (UD) 이진 함수 개체 pairwise, 앞으로 순서로 두 원본 범위에 적용 되는 알고리즘의 두 번째 버전에서을 사용 합니다.

반환 값

함수 개체로 변환 하는 출력 요소를 받는 대상 범위의 마지막 요소를 지나서 위치 주소 출력 반복기입니다.

설명

참조 하는 범위의 유효 해야 합니다. 모든 포인터는 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

참고 항목

참조

표준 템플릿 라이브러리