CKTIS / C++
std::visit — volanie funkčného objektu pre aktívne alternatívy
std::visit z hlavičky <variant> volá volateľný objekt s aktívnou hodnotou každého odovzdaného objektu std::variant. Ak sa neodovzdá žiadny variant, std::visit(visitor) zavolá visitor bez argumentov, pokiaľ je také volanie platné. Alternatívy sa vyberajú za behu, ale platnosť volania pre každú kombináciu alternatív sa kontroluje pri preklade.
Verzia: 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...) z <variant> odovzdá aktívne hodnoty objektu visitor. Pri viacerých variantoch odovzdá jednu hodnotu z každého. Zachováva kvalifikáciu const a kategóriu hodnôt argumentov.
Volanie musí byť platné pre každú kombináciu alternatív, nielen pre práve aktívnu kombináciu. Bez výslovného R musia mať všetky výsledky rovnaký typ aj kategóriu hodnôt. Tvar std::visit<R>(visitor, variants...) určuje typ výsledku; každé volanie musí spĺňať požiadavky na konverziu na R, zatiaľ čo R = void výsledok zahodí.
Ak je niektorý variant v stave valueless_by_exception(), funkcia vyvolá std::bad_variant_access. Príklad používa preťaženia Describe, ktoré vracajú std::string. Očakávaný výstup je int: 42 a potom text: hello, každý na samostatnom riadku.
Tento záznam sa týka voľnej funkcie v C++23. Uvedená adresa odkazuje na priebežne sa vyvíjajúci návrh štandardu, nie na nemenný dokument C++23. Nastavenie príznaku kompilátora nepotvrdzuje fungovanie v produkčnom runtime prostredí.
Prí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ýsledok
int: 42 text: hello
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.