Namespaces
Variants

std::ranges:: views:: transform, std::ranges:: transform_view

From cppreference.net
C++
Ranges library
Range adaptors
std::ranges::transform_view
Member functions
(C++26)
Deduction guides
Iterator
Sentinel
ヘッダーで定義 <ranges>
(1)
template < ranges:: input_range V,

std:: copy_constructible F >
requires ranges:: view < V > &&
std:: is_object_v < F > &&
std:: regular_invocable < F & , ranges:: range_reference_t < V >> &&
/* invoke_result_t<F&, range_reference_t<V>>& is a valid type */
class transform_view

: public ranges:: view_interface < transform_view < V, F >>
(C++20以降)
(C++23まで)
template < ranges:: input_range V,

std:: move_constructible F >
requires ranges:: view < V > &&
std:: is_object_v < F > &&
std:: regular_invocable < F & , ranges:: range_reference_t < V >> &&
/* invoke_result_t<F&, range_reference_t<V>>& is a valid type */
class transform_view

: public ranges:: view_interface < transform_view < V, F >>
(C++23以降)
namespace views {

inline constexpr /*unspecified*/ transform = /*unspecified*/ ;

}
(2) (C++20以降)
呼び出しシグネチャ
template < ranges:: viewable_range R, class F >

requires /* 下記参照 */

constexpr ranges:: view auto transform ( R && r, F && fun ) ;
(C++20以降)
template < class F >
constexpr /*range adaptor closure*/ transform ( F && fun ) ;
(C++20以降)
1) 基となるシーケンスの各要素に変換関数を適用した後の view を表すレンジアダプタ。
2) RangeAdaptorObject である。式 views :: transform ( e, f ) は、任意の適切な部分式 e および f に対して 式等価 である transform_view ( e, f ) に等しい。

transform_view は、基になるビュー V がそれぞれのコンセプトをモデル化する場合、 random_access_range 、 bidirectional_range 、 forward_range 、 input_range 、 common_range 、および sized_range のコンセプトをモデル化します。

目次

データメンバ

メンバー 説明
V base_ (private) 基となるビュー
( 説明専用メンバーオブジェクト* )
copyable-box <F> (until C++23) movable-box <F> (since C++23) fun_ (private) 基となる関数オブジェクト
( 説明専用メンバーオブジェクト* )

メンバー関数

transform_view を構築する
(公開メンバ関数)
基盤となる（適合された）ビューのコピーを返す
(公開メンバ関数)
先頭を指すイテレータを返す
(公開メンバ関数)
終端を指すイテレータまたはセンチネルを返す
(公開メンバ関数)
要素数を返す（基盤となる（適合された）範囲が sized_range を満たす場合のみ提供）
(公開メンバ関数)
(C++26)
結果の approximately_sized_range の近似サイズを返す
(公開メンバ関数)
std::ranges::view_interface から継承
派生ビューが空かどうかを返す（ sized_range または forward_range を満たす場合のみ提供）
( std::ranges::view_interface<D> の公開メンバ関数)
(C++23)
範囲の先頭を指す定数イテレータを返す
( std::ranges::view_interface<D> の公開メンバ関数)
(C++23)
範囲の定数イテレータのセンチネルを返す
( std::ranges::view_interface<D> の公開メンバ関数)
派生ビューが空でないかどうかを返す（ ranges::empty が適用可能な場合のみ提供）
( std::ranges::view_interface<D> の公開メンバ関数)
派生ビューの最初の要素を返す（ forward_range を満たす場合に提供）
( std::ranges::view_interface<D> の公開メンバ関数)
派生ビューの最後の要素を返す（ bidirectional_range かつ common_range を満たす場合のみ提供）
( std::ranges::view_interface<D> の公開メンバ関数)
派生ビューの n 番目の要素を返す（ random_access_range を満たす場合のみ提供）
( std::ranges::view_interface<D> の公開メンバ関数)

推論ガイド

ネストされたクラス

イテレータ型
( 説明専用メンバクラステンプレート* )
センチネル型
( 説明専用メンバクラステンプレート* )

例

このコードを実行 
#include <algorithm>
#include <cstdio>
#include <iterator>
#include <ranges>
#include <string>
char rot13a(const char x, const char a)
{
    return a + (x - a + 13) % 26;
}
char rot13(const char x)
{
    if ('Z' >= x and x >= 'A')
        return rot13a(x, 'A');
    if ('z' >= x and x >= 'a')
        return rot13a(x, 'a');
    return x;
}
int main()
{
    auto show = [](const unsigned char x) { std::putchar(x); };
    std::string in{"cppreference.net\n"};
    std::ranges::for_each(in, show);
    std::ranges::for_each(in | std::views::transform(rot13), show);
    std::string out;
    std::ranges::copy(std::views::transform(in, rot13), std::back_inserter(out));
    std::ranges::for_each(out, show);
    std::ranges::for_each(out | std::views::transform(rot13), show);
}

出力: 

cppreference.net
pccersrerapr.pbz
pccersrerapr.pbz
cppreference.net

関連項目

(C++20)
要素の範囲に関数を適用する
(アルゴリズム関数オブジェクト)