Namespaces
Variants

    std::identity

    来自 zh.cppreference.net
     
    C++
     
    工具库
    通用工具
    关系运算符 (C++20 中弃用)
    整数比较函数
    (C++20)(C++20)(C++20)    
    (C++20)
    交换 与 类型操作
    (C++20)
    (C++14)
    (C++11)
    (C++23)
    (C++11)
    (C++23)
    (C++11)
    (C++11)
    (C++17)
    常用词汇类型
    (C++11)
    (C++17)
    (C++17)
    (C++17)
    (C++11)
    (C++11)
    (C++17)
    (C++17)
    (C++23)



     
    函数对象
    函数调用
    (C++17)(C++23)
    恒等函数对象
    (C++20)
    透明运算符包装器
    (C++14)
    (C++14)
    (C++14)
    (C++14)  
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)

    旧的绑定器和适配器
    (直到 C++17*)
    (直到 C++17*)
    (直到 C++17*)
    (直到 C++17*)
    (直到 C++17*)  
    (直到 C++17*)
    (直到 C++17*)(直到 C++17*)(直到 C++17*)(直到 C++17*)
    (直到 C++20*)
    (直到 C++20*)
    (直到 C++17*)(直到 C++17*)
    (直到 C++17*)(直到 C++17*)

    (直到 C++17*)
    (直到 C++17*)(直到 C++17*)(直到 C++17*)(直到 C++17*)
    (直到 C++20*)
    (直到 C++20*)
     
    定义于头文件 <functional> 
    struct identity;
    		(自 C++20 起)

    std::identity 是一个函数对象类型，其 operator() 返回其参数不变。

    成员类型

    类型 定义
    is_transparent 未指定

    成员函数

    operator()
    		返回未经修改的实参
    (公开成员函数)

    std::identity:: operator()

    template < class T >
    constexpr T && operator ( ) ( T && t ) const noexcept ;

    返回 std:: forward < T > ( t ) 。

    参数

    t - 要返回的参数

    返回值

    std:: forward < T > ( t ) 。

    注释

    std::identity 在 约束算法 中作为默认投影使用。通常不需要直接使用它。

    示例

    运行此代码 
    #include <algorithm>
#include <functional>
#include <iostream>
#include <ranges>
#include <string>
struct Pair
{
    int n;
    std::string s;
    friend std::ostream& operator<<(std::ostream& os, const Pair& p)
    {
        return os << '{' << p.n << ", " << p.s << '}';
    }
};
// 可打印经过投影（修改）后范围元素的区间打印机
template<std::ranges::input_range R,
         typename Projection = std::identity> //<- 注意默认投影
void print(std::string_view const rem, R&& range, Projection projection = {})
{
    std::cout << rem << '{';
    std::ranges::for_each(
        range,
        [O = 0](const auto& o) mutable { std::cout << (O++ ? ", " : "") << o; },
        projection
    );
    std::cout << "}\n";
}
int main()
{
    const auto v = {Pair{1, "one"}, {2, "two"}, {3, "three"}};
    print("使用 std::identity 作为投影进行打印: ", v);
    print("投影 Pair::n: ", v, &Pair::n);
    print("投影 Pair::s: ", v, &Pair::s);
    print("使用自定义闭包作为投影进行打印: ", v,
        [](Pair const& p) { return std::to_string(p.n) + ':' + p.s; });
}

    输出： 

    使用 std::identity 作为投影进行打印: {{1, one}, {2, two}, {3, three}}
投影 Pair::n: {1, 2, 3}
投影 Pair::s: {one, two, three}
使用自定义闭包作为投影进行打印: {1:one, 2:two, 3:three}

    参见

    (C++20)
    		返回未经修改的类型实参
    (类模板)