Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::function: kopírovateľný obal volania

std::function uchová ľubovoľný kopírovateľný volateľný objekt zodpovedajúci signatúre a volá ho jednotným rozhraním.

Verzia: C++23

Syntax

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 vymazaním typu. Môže obsahovať ukazovateľ na funkciu, funktor, väzbu či lambdu, ak je uložený typ kopírovateľný a možno ho volať s Args... na výsledok kompatibilný s R. Obal možno kopírovať aj presúvať; kópia skopíruje cieľ, takže hodnotové zachytenia patria každej kópii.

Príklad uloží lambdu zachytávajúcu factor hodnotou do std::function<int(int)>. std::function::operator() zavolá uložený cieľ, takže scale(5) vráti 15. std::function::operator bool oznamuje, či obal obsahuje cieľ; druhý je implicitne skonštruovaný, takže static_cast<bool>(empty) je nepravda a program vypíše 15 0. Pred volaním voliteľného callbacku otestujte booleovský stav, ak nechcete prázdno zámerne riešiť výnimkou.

Volanie prázdneho obalu vyhodí std::bad_function_call; výnimky cieľa sa propagujú. Konštrukcia môže alokovať a vyhodiť std::bad_alloc alebo ľubovoľnú výnimku inicializácie cieľa, vrátane výnimky pri presune z rvalue argumentu; optimalizácia malého objektu nie je zaručená. Lambda iba na presun nespĺňa v C++23 std::function; použite std::move_only_function. Zachytenie referencií nepredlžuje životnosť a môže visieť. target<T>() uspeje len pre presný uložený typ a signatúra nezachováva noexcept.

Prí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ýsledok

15 0

std::function → 15 0

Zdroje