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

C++ 参考手册

C++11
C++14
C++17
C++20
C++ 编译器支持情况表
独立与宿主实现
C++ 语言
C++ 关键词
预处理器
C++ 标准库头文件
具名要求
功能特性测试 (C++20)
工具库
程序支持工具
std::initializer_list
函数对象
std::less
std::mem_fn
std::bind
std::function
std::bad_function_call
std::is_bind_expression
std::is_placeholder
std::placeholders::_1, std::placeholders::_2, ..., std::placeholders::_N
std::invoke
std::not_fn
std::bind_front
std::boyer_moore_searcher
std::default_searcher
std::identity
std::reference_wrapper
std::ref, std::cref
std::unwrap_reference, std::unwrap_ref_decay
std::plus
std::minus
std::negate
std::multiplies
std::divides
std::modulus
std::logical_and
std::logical_or
std::logical_not
std::equal_to
std::not_equal_to
std::greater
std::greater_equal
std::less_equal
std::bit_and
std::bit_or
std::bit_xor
std::bit_not
std::boyer_moore_horspool_searcher
std::unary_function
std::binary_function
std::ptr_fun
std::pointer_to_unary_function
std::pointer_to_binary_function
std::mem_fun_t, std::mem_fun1_t, std::const_mem_fun_t, std::const_mem_fun1_t
std::not1
std::not2
std::bind1st, std::bind2nd
std::mem_fun_ref_t, std::mem_fun1_ref_t, std::const_mem_fun_ref_t, std::const_mem_fun1_ref_t
std::unary_negate
std::binary_negate
std::less<void>
std::apply
库特性测试宏 (C++20)
std::hash
std::pair
std::tuple
std::optional
std::any
std::variant
格式化库 (C++20)
std::integer_sequence
std::exchange
std::make_from_tuple
std::launder
std::to_chars
std::from_chars
std::as_const
std::source_location
变参数函数
std::bitset
std::cmp_equal, cmp_not_equal, cmp_less, cmp_greater, cmp_less_equal, cmp_greater_equal
std::in_range
std::declval
std::forward
std::move
std::move_if_noexcept
std::chars_format
std::piecewise_construct_t
std::piecewise_construct
std::in_place, std::in_place_type, std::in_place_index, std::in_place_t, std::in_place_type_t, std::in_place_index_t
注释
类型支持（基本类型、RTTI、类型特性）
概念库 (C++20)
错误处理
动态内存管理
日期和时间工具
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
输入/输出库
文件系统库
本地化库
正则表达式库
原子操作库
线程支持库
实验性 C++ 特性
有用的资源
索引
std 符号索引
协程支持 (C++20)
C++ 关键词

位置：首页 > C++ 参考手册 >工具库 >函数对象 > std::placeholders::_1, std::placeholders::_2, ..., std::placeholders::_N

定义于头文件 `<functional>`
/see below/ _1; /see below/ _2; . . /see below/ _N;

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

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

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

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

示例

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

运行此代码

#include <functional>
#include <string>
#include <iostream>
 
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(int argc, char* argv[])
{
    typedef std::function<void(const std::string&)> ExampleFunction;
    Object instance;
    std::string str("World");
    ExampleFunction f = std::bind(&Object::hello, &instance, 
                                  std::placeholders::_1);
 
    // 等价于 instance.hello(str)
    f(str);
    f = std::bind(&goodbye, std::placeholders::_1);
 
    // 等价于 goodbye(str)
    f(str);    
    return 0;
}

输出：

Hello World
Goodbye World

参阅

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