CKTIS / C++
std::visit — pozivanje pozivljivog objekta za aktivne alternative
std::visit iz zaglavlja <variant> poziva pozivljivi objekt s aktivnom vrijednošću iz svakog proslijeđenog objekta std::variant. Ako se ne proslijedi nijedna varijanta, std::visit(visitor) poziva visitor bez argumenata, pod uvjetom da je takav poziv valjan. Alternative se odabiru tijekom izvođenja, a valjanost poziva za svaku kombinaciju alternativa provjerava se tijekom prevođenja.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
#include <variant>
std::visit(visitor, variants...)
std::visit<R>(visitor, variants...)std::visit(visitor, variants...) iz <variant> prosljeđuje aktivne vrijednosti objektu visitor. Za više varijanti prosljeđuje po jednu vrijednost iz svake. Čuva kvalifikator const i kategoriju vrijednosti argumenata.
Poziv mora biti valjan za svaku kombinaciju alternativa, a ne samo za trenutačno aktivnu kombinaciju. Bez izričitog R svi rezultati moraju imati isti tip i kategoriju vrijednosti. Oblik std::visit<R>(visitor, variants...) određuje tip rezultata; svaki poziv mora zadovoljiti zahtjeve pretvorbe u R, dok R = void odbacuje rezultat.
Ako je neka varijanta u stanju valueless_by_exception(), funkcija baca std::bad_variant_access. Primjer upotrebljava preopterećenja Describe koja vraćaju std::string. Očekivani je izlaz int: 42, a zatim text: hello, svaki u zasebnom retku.
Ovaj unos obrađuje slobodnu funkciju u C++23. Navedena adresa vodi do nacrta standarda koji se razvija, a ne do nepromjenjivog dokumenta C++23. Postavljanje zastavice prevoditelja ne potvrđuje rad u produkcijskom izvršnom okruženju.
Primjeri
#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';
}
Rezultat
int: 42 text: hello
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.