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.