KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::visit — een callable aanroepen voor actieve alternatieven

std::visit, gedeclareerd in <variant>, roept een callable aan met de actieve waarde van elk meegegeven std::variant-object. Zonder varianten roept std::visit(visitor) de callable visitor zonder argumenten aan, mits die aanroep geldig is. De alternatieven worden tijdens de uitvoering geselecteerd, maar tijdens het compileren wordt voor elke combinatie van alternatieven gecontroleerd of de aanroep geldig is.

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

Syntax

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

std::visit(visitor, variants...) uit <variant> geeft de actieve waarden door aan visitor. Bij meerdere varianten wordt één waarde uit elke variant doorgegeven. De const-kwalificatie en waardecategorie van de argumenten blijven behouden.

De aanroep moet geldig zijn voor elke combinatie van alternatieven, niet alleen voor de combinatie die op dat moment actief is. Zonder expliciet R moeten alle resultaten hetzelfde type en dezelfde waardecategorie hebben. De vorm std::visit<R>(visitor, variants...) geeft het resultaattype op; elke aanroep moet voldoen aan de conversievereisten voor R, terwijl R = void het resultaat negeert.

Als een variant valueless_by_exception() is, gooit de functie std::bad_variant_access. Het voorbeeld gebruikt overloads van Describe die std::string retourneren. De verwachte uitvoer is int: 42, gevolgd door text: hello, elk op een eigen regel.

Dit artikel behandelt de vrije functie in C++23. Het opgegeven adres verwijst naar een ontwerpstandaard die nog in ontwikkeling is, niet naar een vastgelegde C++23-tekst. Een compileroptie instellen bevestigt niet dat de functie in een productieomgeving werkt.

Voorbeelden

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

Resultaat

int: 42
text: hello

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen