std::transform

Defined in header `<algorithm>`

template< class InputIt, class OutputIt, class UnaryOperation > OutputIt transform( InputIt first1, InputIt last1, OutputIt d_first, UnaryOperation unary_op );	(1)

template< class InputIt1, class InputIt2, class OutputIt, class BinaryOperation > OutputIt transform( InputIt1 first1, InputIt1 last1, InputIt2 first2, OutputIt d_first, BinaryOperation binary_op );	(2)

std::transform範囲に指定した関数を適用し、d_firstから始まる別の範囲に結果を格納.

最初のバージョンでは単項演算unary_opは[first1, last1)によって定義された範囲に適用されます。第二版ではバイナリ操作binary_opは二つの範囲の要素のペアに適用されます。[first1, last1)でfirst2や他の初めによって定義された1.

first1, last1	-	変換する要素の最初の範囲 Original: the first range of elements to transform The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
first2	-	変換する要素の第2の範囲の始まり Original: the beginning of the second range of elements to transform The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
d_first	-	目的の範囲の始まりは、`first1`または`first2`に等しいかもしれません Original: the beginning of the destination range, may be equal to `first1` or `first2` The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
unary_op	-	unary operation function object that will be applied. The signature of the function should be equivalent to the following: Ret fun(const Type &a); The signature does not need to have const &. The type Type must be such that an object of type InputIt can be dereferenced and then implicitly converted to Type. The type Ret must be such that an object of type OutputIt can be dereferenced and assigned a value of type Ret.
binary_op	-	binary operation function object that will be applied. The signature of the function should be equivalent to the following: Ret fun(const Type1 &a, const Type2 &b); The signature does not need to have const &. The types Type1 and Type2 must be such that objects of types InputIt1 and InputIt2 can be dereferenced and then implicitly converted to Type1 and Type2 respectively. The type Ret must be such that an object of type OutputIt can be dereferenced and assigned a value of type Ret.
型の要件
- `InputIt` は `InputIterator` の要求を満足しなければなりません。
- `InputIt1` は `InputIterator` の要求を満足しなければなりません。
- `InputIt2` は `InputIterator` の要求を満足しなければなりません。
- `OutputIt` は `OutputIterator` の要求を満足しなければなりません。

[編集] 値を返します

最後の要素は、過去の要素への出力イテレータは、形質転換された.

[編集] 複雑性

1)

std::distance(first1, last1)の正確unary_opアプリケーション

2)

std::distance(first1, last1)の正確binary_opアプリケーション

[編集] 要件

unary_opとbinary_op全く副作用がありません。 (C++11以前)

unary_opとbinary_op終了イテレータを含む任意のイテレータを無効、または関与の範囲の任意の要素を変更しません。 (C++11およびそれ以降)

これらの要件の目的は、並列またはstd::transformのアウトオブオーダーの実装を可能にすることである。順序でシーケンスに関数を適用するには、std::for_eachを使用.

[編集] 可能な実装

First version

template<class InputIt, class OutputIt, class UnaryOperation>
OutputIt transform(InputIt first1, InputIt last1, OutputIt d_first, 
                   UnaryOperation unary_op)
{
    while (first1 != last1) {
        *d_first++ = unary_op(*first1++);
    }
    return d_first;
}

Second version

template<class InputIt1, class InputIt2, 
         class OutputIt, class BinaryOperation>
OutputIt transform(InputIt first1, InputIt last1, InputIt first2, 
                   OutputIt d_first, BinaryOperation binary_op)
{
    while (first1 != last1) {
        *d_first++ = binary_op(*first1++, *first2++);
    }
    return d_first;
}

[編集] 例

次のコードは、toupperは関数を使って文字列を大文字に変換するために変換を使用しています

このコードを実行します

#include <string>
#include <cctype>
#include <algorithm>
#include <iostream>
 
int main()
{
    std::string s("hello");
    std::transform(s.begin(), s.end(), s.begin(), (int (*)(int))std::toupper);
    std::cout << s;
 }

出力:

HELLO

[編集] 参照


for_each	ある範囲の要素に関数が適用されます Original: applies a function to a range of elements The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (関数テンプレート) [edit]

言語
コンセプト
ユーティリティライブラリ
ストリングスライブラリ
コンテナライブラリ
アルゴリズムライブラリ
イテレータライブラリ
ニューメリックスライブラリ
入力/出力ライブラリ
ローカライゼーションライブラリ
正規表現ライブラリ (C++11)
アトミック操作ライブラリ (C++11)
スレッドのサポートライブラリ (C++11)

cppreference.com

検索

名前空間

変種

表示

操作