Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::move_only_function — um wrapper de callable que só pode ser movido

C++23 std::move_only_function armazena um objeto chamável com uma assinatura especificada, incluindo uma lambda que possui um recurso exclusivo. O wrapper pode ser movido, mas não copiado. Tem de conter um destino antes de ser chamado.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#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, declarado em <functional> e disponível desde C++23, é um wrapper com apagamento de tipos: expõe uma assinatura de chamada fixa e oculta o tipo concreto armazenado. Ao contrário de std::function, não exige um destino copiável; pode conter uma lambda que captura um std::unique_ptr. O próprio wrapper não pode ser copiado.

O tipo da assinatura pode incluir const, um qualificador de referência & ou && e noexcept. Estes elementos determinam como o wrapper pode ser chamado e impõem requisitos ao destino. Por exemplo, std::move_only_function<int() && noexcept> exige um wrapper rvalue e um destino chamável sem lançar exceções. O qualificador &&, por si só, não garante uma utilização única.

Um wrapper construído por omissão está vazio. Verifique if (f) antes de o chamar quando não tiver a certeza de que existe um destino: chamar um wrapper vazio em C++23 causa comportamento indefinido, não uma exceção std::bad_function_call garantida. Atribuir nullptr remove o destino. Após uma operação de movimento, o objeto de origem continua válido, mas tem um valor não especificado; não presuma que está vazio.

O exemplo move um wrapper que contém uma lambda proprietária de um recurso, invoca o destino e, em seguida, remove-o explicitamente. Também é necessário suporte de C++23 na biblioteca padrão; uma opção do compilador, por si só, não comprova a disponibilidade da funcionalidade nem a preparação do ambiente de produção. O código-fonte fornecido é um rascunho de trabalho em evolução, não um texto C++23 imutável.

Exemplos

#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';
}

Resultado

42
false

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes