Namespaces
Variants

std::function

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>
template< class >
class function; /* undefined */
で定義 (C++11以上)
template< class R, class... Args >
class function<R(Args...)>;
(C++11以上)

クラステンプレート std::function は、汎用の多相的な関数ラッパーです。std::function のインスタンスは、あらゆる CopyConstructible Callable ターゲット — 関数(へのポインタ)、ラムダ式、bind式、またはその他の関数オブジェクト、さらにメンバ関数へのポインタやデータメンバへのポインタ — を格納、コピー、および呼び出すことができます。

格納された呼び出し可能オブジェクトは、ターゲット と呼ばれます。もし std::function がターゲットを持たない場合、それは std::function空 と呼ばれます。空の ターゲット の呼び出しを行うと、空 std::function に対しては std::bad_function_call 例外が送出されます。

std::function は CopyConstructible および CopyAssignable の要件を満たします。

メンバー型

型 定義
result_type R
argument_type
(C++17で非推奨) (C++20で削除)
T の場合、 sizeof... ( Args ) == 1 かつ T が Args... 内の最初かつ唯一の型である場合
first_argument_type
(C++17で非推奨) (C++20で削除)
T1 の場合、 sizeof... ( Args ) == 2 かつ T1 が Args... 内の2つの型の最初の型である場合
second_argument_type
(C++17で非推奨) (C++20で削除)
T2 の場合、 sizeof... ( Args ) == 2 かつ T2 が Args... 内の2つの型の2番目の型である場合

メンバー関数

新しい std::function インスタンスを構築する
(公開メンバ関数)
std::function インスタンスを破棄する
(公開メンバ関数)
新しいターゲットを代入する
(公開メンバ関数)
内容を交換する
(公開メンバ関数)
(removed in C++17)
新しいターゲットを代入する
(公開メンバ関数)
ターゲットが含まれているかチェックする
(公開メンバ関数)
ターゲットを呼び出す
(公開メンバ関数)
ターゲットアクセス
格納されたターゲットの typeid を取得する
(公開メンバ関数)
格納されたターゲットへのポインタを取得する
(公開メンバ関数)

非メンバー関数

std::swap アルゴリズムを特殊化
(関数テンプレート)
(C++20で削除)
std::function と nullptr を比較
(関数テンプレート)

ヘルパークラス

std::uses_allocator 型特性の特殊化
(クラステンプレートの特殊化)

推論ガイド (C++17以降)

注記

戻り値型が参照であるstd::functionが、末尾戻り値型なしのラムダ式から初期化される場合には注意が必要です。autoの推論規則により、このようなラムダ式は常にprvalueを返します。その結果、返される参照は通常、std::function::operator()が戻る時点で寿命が終了する一時オブジェクトに束縛されることになります。

(C++23まで)

参照を返すstd::functionがprvalueを返す関数または関数オブジェクト(末尾戻り値型なしのラムダ式を含む)から初期化される場合、返された参照を一時オブジェクトに束縛することが禁止されているため、プログラムは不適格となります。

(C++23以降)
std::function<const int&()> F([] { return 42; }); // C++23以降エラー: 返された参照を一時オブジェクトに束縛できない
                                                  // 返された参照を一時オブジェクトに束縛できない
int x = F(); // C++23まで未定義動作: F()の結果はダングリング参照
std::function<int&()> G([]() -> int& { static int i{0x2A}; return i; }); // OK
std::function<const int&()> H([i{052}] -> const int& { return i; }); // OK

例

#include <functional>
#include <iostream>
struct Foo
{
    Foo(int num) : num_(num) {}
    void print_add(int i) const { std::cout << num_ + i << '\n'; }
    int num_;
};
void print_num(int i)
{
    std::cout << i << '\n';
}
struct PrintNum
{
    void operator()(int i) const
    {
        std::cout << i << '\n';
    }
};
int main()
{
    // 自由関数の格納
    std::function<void(int)> f_display = print_num;
    f_display(-9);
    // ラムダ式の格納
    std::function<void()> f_display_42 = []() { print_num(42); };
    f_display_42();
    // std::bindの呼び出し結果の格納
    std::function<void()> f_display_31337 = std::bind(print_num, 31337);
    f_display_31337();
    // メンバ関数の呼び出しの格納
    std::function<void(const Foo&, int)> f_add_display = &Foo::print_add;
    const Foo foo(314159);
    f_add_display(foo, 1);
    f_add_display(314159, 1);
    // データメンバアクセサの呼び出しの格納
    std::function<int(Foo const&)> f_num = &Foo::num_;
    std::cout << "num_: " << f_num(foo) << '\n';
    // メンバ関数とオブジェクトの呼び出しの格納
    using std::placeholders::_1;
    std::function<void(int)> f_add_display2 = std::bind(&Foo::print_add, foo, _1);
    f_add_display2(2);
    // メンバ関数とオブジェクトポインタの呼び出しの格納
    std::function<void(int)> f_add_display3 = std::bind(&Foo::print_add, &foo, _1);
    f_add_display3(3);
    // 関数オブジェクトの呼び出しの格納
    std::function<void(int)> f_display_obj = PrintNum();
    f_display_obj(18);
    auto factorial = [](int n)
    {
        // 「再帰的ラムダ」をエミュレートするためのラムダオブジェクトの格納。追加のオーバーヘッドに注意
        std::function<int(int)> fac = [&](int n) { return (n < 2) ? 1 : n * fac(n - 1); };
        // 「auto fac = [&](int n) {...};」は再帰呼び出しでは機能しないことに注意
        return fac(n);
    };
    for (int i{5}; i != 8; ++i)
        std::cout << i << "! = " << factorial(i) << ";  ";
    std::cout << '\n';
}

出力例:

-9
42
31337
314160
314160
num_: 314159
314161
314162
18
5! = 120;  6! = 720;  7! = 5040;

関連項目

指定された呼び出しシグネチャで修飾子をサポートする任意の呼び出し可能オブジェクトのムーブ専用ラッパー
(クラステンプレート)
指定された呼び出しシグネチャで修飾子をサポートする任意のコピー構築可能な呼び出し可能オブジェクトのコピー可能ラッパー
(クラステンプレート)
任意の呼び出し可能オブジェクトの非所有ラッパー
(クラステンプレート)
空の std::function を呼び出したときにスローされる例外
(クラス)
(C++11)
メンバへのポインタから関数オブジェクトを作成する
(関数テンプレート)
typeid 型の情報を問い合わせ、その型を表す std::type_info オブジェクトを返す