CKTIS / C++
std::visit — wywołanie funkcji dla aktywnej alternatywy
std::visit z nagłówka <variant> wywołuje obiekt wywoływalny, przekazując mu aktywną wartość z każdego podanego obiektu std::variant. Gdy nie podano żadnego wariantu, std::visit(visitor) wywołuje visitor bez argumentów, o ile takie wywołanie jest poprawne. Wybór alternatyw następuje podczas wykonania, ale poprawność wywołania dla każdej ich kombinacji jest sprawdzana podczas kompilacji.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#include <variant>
std::visit(visitor, variants...)
std::visit<R>(visitor, variants...)std::visit(visitor, variants...) z nagłówka <variant> przekazuje aktywne wartości do visitor. Dla kilku wariantów przekazuje po jednej wartości z każdego. Zachowuje kwalifikację const i kategorię wartości argumentów.
Wywołanie musi być poprawne dla każdej kombinacji alternatyw, nie tylko aktualnie aktywnej. Bez jawnego R wszystkie wyniki muszą mieć identyczny typ i kategorię wartości. Postać std::visit<R>(visitor, variants...) określa typ wyniku; każde wywołanie musi spełniać wymagania konwersji do R, a R = void odrzuca wynik.
Jeśli którykolwiek wariant jest valueless_by_exception(), funkcja zgłasza std::bad_variant_access. Przykład używa przeciążeń Describe zwracających std::string. Oczekiwane wyjście to kolejno int: 42 i text: hello, każde w osobnym wierszu.
Zakres wpisu to wolna funkcja w C++23. Podany adres prowadzi do rozwijanego szkicu standardu, a nie zamrożonego dokumentu C++23. Ustawienie flagi kompilatora nie potwierdza działania w środowisku produkcyjnym.
Przykłady
#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';
}
Wynik
int: 42 text: hello
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.