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

CKTIS / C++

std::visit — volání funkčního objektu pro aktivní alternativy

std::visit z hlavičky <variant> volá volatelný objekt s aktivní hodnotou každého předaného objektu std::variant. Pokud není předána žádná varianta, std::visit(visitor) zavolá visitor bez argumentů, je-li takové volání platné. Alternativy se vybírají za běhu, ale platnost volání pro každou kombinaci alternativ se kontroluje při překladu.

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

Syntaxe

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

std::visit(visitor, variants...) z <variant> předá aktivní hodnoty objektu visitor. U několika variant předá jednu hodnotu z každé. Zachovává kvalifikaci const a kategorii hodnot argumentů.

Volání musí být platné pro každou kombinaci alternativ, nejen pro právě aktivní kombinaci. Bez výslovného R musí mít všechny výsledky stejný typ i kategorii hodnot. Tvar std::visit<R>(visitor, variants...) určuje typ výsledku; každé volání musí splňovat požadavky na konverzi na R, zatímco R = void výsledek zahodí.

Pokud je některá varianta ve stavu valueless_by_exception(), funkce vyvolá std::bad_variant_access. Příklad používá přetížení Describe, která vracejí std::string. Očekávaný výstup je int: 42 a poté text: hello, každý na samostatném řádku.

Tento záznam se týká volné funkce v C++23. Uvedená adresa odkazuje na průběžně se vyvíjející návrh standardu, nikoli na neměnný dokument C++23. Nastavení příznaku kompilátoru nepotvrzuje fungování v produkčním běhovém prostředí.

Příklady

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

Výsledek

int: 42
text: hello

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