Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::function: kopírovatelný obal volání

std::function uchová libovolný kopírovatelný volatelný objekt odpovídající signatuře a volá jej jednotným rozhraním.

Verze: C++23

Syntaxe

template<class Signature> class std::function;

template<class R, class... Args>
class std::function<R(Args...)> {
public:
    function() noexcept;
    template<class F> function(F&& f);
    explicit operator bool() const noexcept;
    R operator()(Args... args) const;
};

std::function<R(Args...)> z <functional> je polymorfní obal s vymazáním typu. Může obsahovat ukazatel na funkci, funktor, vazbu či lambdu, pokud je uložený typ kopírovatelný a lze jej volat s Args... na výsledek kompatibilní s R. Obal lze kopírovat i přesouvat; kopie zkopíruje cíl, takže hodnotové záchyty jsou součástí každé kopie.

Příklad uloží lambdu zachycující factor hodnotou do std::function<int(int)>. std::function::operator() zavolá uložený cíl, takže scale(5) vrátí 15. std::function::operator bool oznamuje, zda obal cíl obsahuje; druhý je implicitně zkonstruován, takže static_cast<bool>(empty) je nepravda a program vypíše 15 0. Před voláním volitelného callbacku otestujte booleovský stav, pokud nechcete prázdný stav záměrně řešit výjimkou.

Volání prázdného obalu vyhodí std::bad_function_call; výjimky cíle se propagují. Konstrukce může alokovat a vyhodit std::bad_alloc nebo libovolnou výjimku inicializace cíle, včetně výjimky při přesunu z rvalue argumentu; optimalizace malého objektu není zaručena. Lambda pouze pro přesun nesplňuje v C++23 std::function; použijte std::move_only_function. Záchyt referencí neprodlužuje životnost a může viset. target<T>() uspěje jen pro přesný uložený typ a signatura obalu nezachovává noexcept.

Příklady

#include <functional>
#include <iostream>

int main() {
    const int factor = 3;
    std::function<int(int)> scale = [factor](int value) {
        return factor * value;
    };
    std::function<int(int)> empty;

    std::cout << scale(5) << ' ' << static_cast<bool>(empty) << '\n';
}

Výsledek

15 0

std::function → 15 0

Zdroje