Namespaces
Variants

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

ja.cppreference.net より
 
 
ユーティリティライブラリ
言語サポート
型サポート (基本型、RTTI)
ライブラリ機能テストマクロ (C++20)
プログラムユーティリティ
可変引数関数
コルーチンサポート (C++20)
契約サポート (C++26)
三方比較
(C++20)
(C++20)(C++20)(C++20)    
(C++20)(C++20)(C++20)

汎用ユーティリティ
関係演算子 (C++20で非推奨)
整数比較関数
(C++20)(C++20)(C++20)    
(C++20)
swap と 型操作
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
共通語彙型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(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++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>
/* 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::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); // equivalent to instance.hello(str)
    f = std::bind(&goodbye, std::placeholders::_1);
    f(str); // equivalent to 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';
    };
    // binding the 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

関連項目

(C++11)
1つ以上の引数を関数オブジェクトにバインドする
(関数テンプレート)
オブジェクトが標準プレースホルダーであるか、プレースホルダーとして使用できることを示す
(クラステンプレート)
(C++11)
tie を使用してtupleを展開する際に要素をスキップするためのプレースホルダー
(定数)