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

CKTIS / C++

std::invoke: jednotné volání callable

std::invoke volá funkce, funkční objekty a ukazatele na členy jedním rozhraním s perfect forwarding.

Verze: C++23

Syntaxe

template<class F, class... Args>
constexpr std::invoke_result_t<F, Args...>
std::invoke(F&& callable, Args&&... args)
    noexcept(std::is_nothrow_invocable_v<F, Args...>);

std::invoke(f,args...) provádí INVOKE: běžný callable dostane předané argumenty; ukazatel na členskou funkci potřebuje objekt, ukazatel nebo std::reference_wrapper; ukazatel na datový člen vrací člen. Funkce se účastní jen když std::is_invocable_v<F,Args...> je true.

Příklad volá Counter::add, čte Counter::base a spouští lambdu, proto vypíše 12 7 12. Kategorie hodnot a const se zachovají přes std::forward, takže přístup k datu může vrátit referenci.

Typ výsledku je std::invoke_result_t<F,Args...> a podmíněné noexcept odpovídá std::is_nothrow_invocable_v; výjimky se šíří. Nekompatibilní příjemce členu způsobí, že std::is_invocable_v je false a přetížení std::invoke není dostupné. Nedefinované chování naopak vzniká přístupem přes jinak kompatibilní, ale null nebo visící ukazatel či referenci. Objekt a reference musí během volání žít; std::invoke práci neodkládá ani jejich životnost nespravuje.

Příklady

#include <functional>
#include <iostream>

struct Counter {
    int base;
    int add(int value) const { return base + value; }
};

int main() {
    const Counter counter{7};
    std::cout << std::invoke(&Counter::add, counter, 5) << ' '
              << std::invoke(&Counter::base, counter) << ' '
              << std::invoke([](int a, int b) { return a * b; }, 3, 4) << '\n';
}

Výsledek

12 7 12

std::invoke → 12 7 12

Zdroje