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 /* see below */

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 ) 与 transform_view ( e, f ) 对于任何合适的子表达式 e 和 f 均构成 表达式等价 。

transform_view 在底层视图 V 满足相应概念时，实现以下概念模型： random_access_range 、 bidirectional_range 、 forward_range 、 input_range 、 common_range 以及 sized_range 。

目录

数据成员

成员 描述
V base_ (私有) 底层视图
( 仅用于说明的成员对象* )
copyable-box <F> (C++23 前) movable-box <F> (C++23 起) fun_ (私有) 底层函数对象
( 仅用于说明的成员对象* )

成员函数

构造 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)
对范围内的元素应用函数
(算法函数对象)