Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła