Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::visit — invocare un callable per le alternative attive

std::visit, dichiarata in <variant>, invoca un callable passandogli il valore attivo di ogni oggetto std::variant fornito. Se non viene fornita alcuna variante, std::visit(visitor) invoca visitor senza argomenti, purché l’invocazione sia valida. Le alternative vengono selezionate a runtime, ma la validità dell’invocazione viene verificata in compilazione per ogni combinazione di alternative.

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

Sintassi

#include <variant>
std::visit(visitor, variants...)
std::visit<R>(visitor, variants...)

std::visit(visitor, variants...) di <variant> passa i valori attivi a visitor. Con più varianti, passa un valore da ciascuna. Mantiene la qualificazione const e la categoria di valore degli argomenti.

L’invocazione deve essere valida per ogni combinazione di alternative, non soltanto per quella attiva in quel momento. Senza specificare R, tutti i risultati devono avere lo stesso tipo e la stessa categoria di valore. La forma std::visit<R>(visitor, variants...) specifica il tipo del risultato; ogni invocazione deve soddisfare i requisiti di conversione a R, mentre R = void scarta il risultato.

Se una variante si trova in stato valueless_by_exception(), la funzione genera std::bad_variant_access. L’esempio usa overload di Describe che restituiscono std::string. L’output previsto è int: 42 seguito da text: hello, ciascuno su una riga separata.

Questa voce riguarda la funzione libera in C++23. L’indirizzo fornito rimanda a una bozza dello standard in evoluzione, non a un documento C++23 definitivo. Impostare un’opzione del compilatore non attesta il funzionamento in un ambiente di runtime di produzione.

Esempi

#include <iostream>
#include <string>
#include <variant>

struct Describe {
    std::string operator()(int value) const {
        return "int: " + std::to_string(value);
    }
    std::string operator()(const std::string& value) const {
        return "text: " + value;
    }
};

int main() {
    std::variant<int, std::string> value{42};
    std::cout << std::visit(Describe{}, value) << '\n';
    value = std::string{"hello"};
    std::cout << std::visit(Describe{}, value) << '\n';
}

Risultato

int: 42
text: hello

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti