CKTIS / C++
std::visit — klicanje klicljivega objekta za aktivne alternative
std::visit iz glave <variant> pokliče klicljivi objekt z aktivno vrednostjo vsakega podanega objekta std::variant. Če ni podana nobena varianta, std::visit(visitor) pokliče visitor brez argumentov, če je tak klic veljaven. Alternative se izberejo med izvajanjem, veljavnost klica za vsako kombinacijo alternativ pa se preveri med prevajanjem.
Različica: 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> posreduje aktivne vrednosti objektu visitor. Pri več variantah posreduje po eno vrednost iz vsake. Ohrani kvalifikator const in kategorijo vrednosti argumentov.
Klic mora biti veljaven za vsako kombinacijo alternativ, ne le za trenutno aktivno kombinacijo. Brez izrecnega R morajo imeti vsi rezultati enak tip in kategorijo vrednosti. Oblika std::visit<R>(visitor, variants...) določa tip rezultata; vsak klic mora izpolnjevati zahteve za pretvorbo v R, medtem ko R = void rezultat zavrže.
Če je katera koli varianta v stanju valueless_by_exception(), funkcija sproži std::bad_variant_access. Primer uporablja preobremenitve Describe, ki vračajo std::string. Pričakovani izpis je int: 42, nato pa text: hello, vsak v svoji vrstici.
Ta vnos obravnava prosto funkcijo v C++23. Navedeni naslov vodi do razvijajočega se osnutka standarda, ne do nespremenjenega dokumenta C++23. Nastavitev zastavice prevajalnika ne potrjuje delovanja v produkcijskem izvajalnem okolju.
Primeri
#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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.