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

CKTIS / C++

std::move_only_function — přesouvatelný obal pro volatelný objekt

C++23 std::move_only_function ukládá volatelný objekt s určenou signaturou, včetně lambda výrazu, který vlastní výhradní prostředek. Obal lze přesouvat, ale ne kopírovat. Před zavoláním musí obsahovat cílový objekt.

Verze: C++23; repository compiler flag, production runtime not attested

Syntaxe

#include <functional>
std::move_only_function<R(Args...)> f;
std::move_only_function<R(Args...) const> cf;
std::move_only_function<R(Args...) &> lf;
std::move_only_function<R(Args...) && noexcept> rf;

std::move_only_function, deklarovaný v <functional> a dostupný od C++23, je obal s type erasure: poskytuje pevnou signaturu volání a skrývá konkrétní typ uloženého objektu. Na rozdíl od std::function nevyžaduje kopírovatelný cílový objekt; může obsahovat lambda výraz zachycující std::unique_ptr. Samotný obal nelze kopírovat.

Typ signatury může obsahovat const, referenční kvalifikátor & nebo && a noexcept. Ty určují, jak lze obal volat, a omezují cílový objekt. Například std::move_only_function<int() && noexcept> vyžaduje obal jako r-hodnotu a cílový objekt, který lze volat bez vyvolání výjimky. Samotný kvalifikátor && nezaručuje jednorázové použití.

Obal vytvořený výchozím způsobem je prázdný. Pokud není jisté, zda obsahuje cíl, před voláním ověřte if (f): zavolání prázdného obalu v C++23 způsobí nedefinované chování, nikoli zaručenou výjimku std::bad_function_call. Přiřazením nullptr se cíl odstraní. Po přesunutí zůstává zdrojový objekt platný, ale má nespecifikovanou hodnotu; nepředpokládejte, že je prázdný.

Příklad přesune obal obsahující lambda výraz vlastnící prostředek, zavolá cíl a potom jej výslovně odstraní. Podporu C++23 musí poskytovat také standardní knihovna; samotný příznak kompilátoru nepotvrzuje dostupnost funkce ani připravenost produkčního prostředí. Dodaný zdrojový text je průběžně upravovaný pracovní návrh, nikoli neměnný text C++23.

Příklady

#include <functional>
#include <iostream>
#include <memory>
#include <utility>

int main() {
    std::move_only_function<int(int)> add =
        [base = std::make_unique<int>(40)](int x) {
            return *base + x;
        };

    auto task = std::move(add);
    if (task) {
        std::cout << task(2) << '\n';
    }

    task = nullptr;
    std::cout << std::boolalpha << static_cast<bool>(task) << '\n';
}

Výsledek

42
false

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje