Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori