std::placeholders::_1, std::placeholders::_2, ..., std::placeholders::_N

在标头 `<functional>` 定义
/* 见下文 / _1; / 见下文 / _2; . . / 见下文 */ _N;

std::placeholders 命名空间含有占位对象 [_1, . . . _N]，其中 N 是实现定义的最大数字。

当用作 std::bind 表达式中的实参时，占位符对象被存储于生成的函数对象中，而以未绑定实参调用函数对象时，每个占位符 _N 被对应的第 N 个未绑定实参替换。

每个占位符如同以 extern /* 未指明 */ _1; 声明。	(C++17 前)
鼓励实现如同以 inline constexpr /* 未指明 / _1; 声明占位符，尽管标准仍然允许以 extern / 未指明 */ _1; 声明它们。	(C++17 起)

占位符对象的类型可默认构造 (DefaultConstructible) 且可复制构造 (CopyConstructible) ，其默认复制/移动构造函数不抛异常，且对于任何占位符 _N，类型 std::is_placeholder<decltype(_N)> 有定义且从 std::integral_constant<int, N> 派生。

示例

下列代码展示以占位符实参创建函数对象。

运行此代码

#include <functional>
#include <iostream>
#include <string>
 
void goodbye(const std::string& s)
{
    std::cout << "Goodbye " << s << '\n';
}
 
class Object
{
public:
    void hello(const std::string& s)
    {
        std::cout << "Hello " << s << '\n';
    }
};
 
int main()
{
    using namespace std::placeholders;
 
    using ExampleFunction = std::function<void(const std::string&)>;
    Object instance;
    std::string str("World");
 
    ExampleFunction f = std::bind(&Object::hello, &instance, _1);
    f(str); // 等价于 instance.hello(str)
 
    f = std::bind(&goodbye, std::placeholders::_1);
    f(str); // 等价于 goodbye(str)
 
    auto lambda = [](std::string pre, char o, int rep, std::string post)
    {
        std::cout << pre;
        while (rep-- > 0)
            std::cout << o;
        std::cout << post << '\n';
    };
 
    // 绑定 lambda:
    std::function<void(std::string, char, int, std::string)> g =
        std::bind(&decltype(lambda)::operator(), &lambda, _1, _2, _3, _4);
    g("G", 'o', 'o'-'g', "gol");
}

输出：

Hello World
Goodbye World
Goooooooogol

参阅

bind (C++11)	绑定一或多个实参到函数对象 (函数模板)
is_placeholder (C++11)	表明一个对象是标准占位符，或者可以用作标准占位符 (类模板)
ignore (C++11)	用 `tie` 解包 `tuple` 时用来跳过元素的占位符 (常量)

编译器支持
自立实现与有宿主实现
语言
标准库
标准库标头
具名要求
功能特性测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用工具库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
技术规范
符号索引
外部库

std::placeholders::_1, std::placeholders::_2, ..., std::placeholders::_N

示例

参阅

导航