std::is_placeholder

 

C++

编译器支持

独立和宿主式

语言

标准库

标准库头文件

具名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

工具库

语言支持 类型支持 (基本类型，RTTI) 库特性测试宏 (C++20) 程序工具 可变参数函数 initializer_list (C++11) is_constant_evaluated (C++20) is_within_lifetime (C++26) source_location (C++20) 协程支持 (C++20) 契约式编程支持 (C++26) 三路比较 three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20)   is_eqis_ltis_lteq (C++20)(C++20)(C++20)   is_neqis_gtis_gteq (C++20)(C++20)(C++20)

通用工具 函数对象 位操作 (C++20) bitset hash (C++11) 关系运算符 (C++20 中已弃用) rel_ops::operator!=rel_ops::operator>    rel_ops::operator<=rel_ops::operator>= 整数比较函数 cmp_equalcmp_lesscmp_less_than (C++20)(C++20)(C++20)   cmp_not_equalcmp_greatercmp_greater_than (C++20)(C++20)(C++20) in_range (C++20) 交换 和 类型操作 swap ranges::swap (C++20) exchange (C++14) declval (C++11) to_underlying (C++23) forward (C++11) forward_like (C++23) move (C++11) move_if_noexcept (C++11) as_const (C++17) 通用词汇类型 pair tuple (C++11) optional (C++17) any (C++17) variant (C++17) tuple_size (C++11) tuple_element (C++11) apply (C++17) make_from_tuple (C++17) expected (C++23)

 

函数对象

函数包装器 function (C++11) move_only_function (C++23) copyable_function (C++26) function_ref (C++26) mem_fn (C++11) bad_function_call (C++11)	偏函数应用 bind_frontbind_back (C++20)(C++23) bind (C++11) is_bind_expression (C++11) is_placeholder (C++11) _1, _2, _3, ... (C++11)
函数调用 invokeinvoke_r (C++17)(C++23) 恒等函数对象 identity (C++20)	引用包装器 reference_wrapper (C++11) refcref (C++11)(C++11) unwrap_referenceunwrap_ref_decay (C++20)(C++20)
运算符包装器 plus minus negate multiplies divides modulus bit_and bit_or bit_not (C++14)   bit_xor equal_to not_equal_to greater less greater_equal less_equal logical_and logical_or logical_not	透明运算符包装器 plus<> (C++14) minus<> (C++14) negate<> (C++14) multiplies<> (C++14)   divides<> (C++14) modulus<> (C++14) bit_and<> (C++14) bit_or<> (C++14) bit_not<> (C++14) bit_xor<> (C++14) equal_to<> (C++14) not_equal_to<> (C++14) greater<> (C++14) less<> (C++14) greater_equal<> (C++14) less_equal<> (C++14) logical_and<> (C++14) logical_or<> (C++14) logical_not<> (C++14)
取反器 not_fn (C++17) 搜索器 default_searcher (C++17) boyer_moore_searcher (C++17) boyer_moore_horspool_searcher (C++17)	约束比较器 ranges::equal_to (C++20) ranges::not_equal_to (C++20) ranges::greater (C++20) ranges::less (C++20) ranges::greater_equal (C++20) ranges::less_equal (C++20) compare_three_way (C++20)
旧式绑定器和适配器
unary_function (在 C++17* 前已弃用) binary_function (在 C++17* 前已弃用) ptr_fun (在 C++17* 前已弃用) pointer_to_unary_function (在 C++17* 前已弃用) pointer_to_binary_function (在 C++17* 前已弃用)   mem_fun (在 C++17* 前已弃用) mem_fun_tmem_fun1_tconst_mem_fun_tconst_mem_fun1_t (在 C++17* 前已弃用)(在 C++17* 前已弃用)(在 C++17* 前已弃用)(在 C++17* 前已弃用) not1 (在 C++20* 前已弃用) not2 (在 C++20* 前已弃用)	binder1stbinder2nd (在 C++17* 前已弃用)(在 C++17* 前已弃用) bind1stbind2nd (在 C++17* 前已弃用)(在 C++17* 前已弃用) mem_fun_ref (在 C++17* 前已弃用) mem_fun_ref_tmem_fun1_ref_tconst_mem_fun_ref_tconst_mem_fun1_ref_t (在 C++17* 前已弃用)(在 C++17* 前已弃用)(在 C++17* 前已弃用)(在 C++17* 前已弃用) unary_negate (在 C++20* 前已弃用) binary_negate (在 C++20* 前已弃用)

 

定义于头文件 <functional>
template< class T > struct is_placeholder;		(自 C++11 起)

如果 T 是标准占位符 (_1, _2, _3, ...) 的类型，则此模板派生自 std::integral_constant<int, 1>, std::integral_constant<int, 2>, std::integral_constant<int, 3>，依此类推。

如果 T 不是标准占位符类型，则此模板派生自 std::integral_constant<int, 0>。

程序可以为用户定义类型 T 特化此模板，以实现以 std::integral_constant<int, N> 为基特征的 UnaryTypeTrait，其中正数 N 指示 T 应被视为第 N^th 占位符类型。

std::bind 使用 std::is_placeholder 检测未绑定参数的占位符。

辅助变量模板

template< class T > constexpr int is_placeholder_v = is_placeholder<T>::value;		(自 C++17 起)

继承自 std::integral_constant

成员常量

value [静态]

占位符值或对于非占位符类型为 ​0​ (公共静态成员常量)

成员函数

operator int	将对象转换为 int，返回 value (公共成员函数)
operator() (C++14)	返回 value (公共成员函数)

成员类型

类型	定义
value_type	int
type	std::integral_constant<int, value>

示例

运行此代码

#include <functional>
#include <iostream>
#include <type_traits>
 
struct My_2 {} my_2;
 
namespace std
{
    template<>
    struct is_placeholder<My_2> : public integral_constant<int, 2> {};
}
 
int f(int n1, int n2)
{
    return n1 + n2;
}
 
int main()
{
    std::cout << "Standard placeholder _5 is for the argument number "
              << std::is_placeholder_v<decltype(std::placeholders::_5)>
              << '\n';
 
    auto b = std::bind(f, my_2, 2);
    std::cout << "Adding 2 to 11 selected with a custom placeholder gives " 
              << b(10, 11) // the first argument, namely 10, is ignored
              << '\n';
}

输出

Standard placeholder _5 is for the argument number 5
Adding 2 to 11 selected with a custom placeholder gives 13

参见

bind (C++11)	将一个或多个参数绑定到函数对象 (函数模板)
_1, _2, _3, _4, ... (C++11)	std::bind 表达式中未绑定参数的占位符 (常量)