Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

std::variant — ena od fiksne množice alternativnih tipov

std::variant hrani vrednost enega od alternativnih tipov, določenih s parametri predloge, in upravlja njeno življenjsko dobo. Omogoča modeliranje podatkov, kot sta »število ali besedilo«, ter varno preverjanje in obravnavo aktivne alternative.

Različica: C++23; repository compiler flag, production runtime not attested

Sintaksa

#include <variant>
std::variant<Types...> value;
std::get<T>(value);
std::get_if<T>(&value);
std::visit(visitor, value);

std::variant<Types...> iz <variant> predstavlja zaprto množico alternativnih tipov. Vsebovana vrednost je znotraj objekta; aktivna je samo ena alternativa naenkrat, razen v spodaj opisanem stanju brez vrednosti. Privzeta konstrukcija inicializira prvo alternativo z vrednostjo in zahteva, da jo je mogoče privzeto konstruirati. Prva alternativa tipa std::monostate lahko predstavlja namerno prazno stanje.

index() vrne indeks aktivne alternative, ki se začne z nič. std::get<T>(value) vrne referenco, če je aktivna alternativa tipa T. Sproži std::bad_variant_access, če je aktivna druga alternativa ali če ni aktivna nobena. std::get_if<T>(&value) vrne kazalec ali nullptr, ne da bi sprožil izjemo. Dostop po tipu zahteva, da se ta tip na seznamu alternativ pojavi natanko enkrat; pri ponovljenih tipih uporabite dostop po indeksu, na primer std::get<0>(value).

std::visit(visitor, value) pokliče klicljiv objekt z aktivno vrednostjo. Objekt mora obravnavati vsako alternativo; pri prikazani obliki klica morajo imeti vsi možni rezultati isti tip in kategorijo vrednosti. Dodelitev ali emplace lahko spremeni aktivno alternativo. Izjema med nekaterimi takimi operacijami lahko objekt pusti brez vrednosti: takrat valueless_by_exception() vrne true, index() vrne std::variant_npos, std::get in std::visit pa sprožita std::bad_variant_access. To se razlikuje od shranjevanja std::monostate.

Primer najprej prebere int, ga nato zamenja s tipom std::string in vrednost obdela z std::visit. Ta vnos je namenjen C++23; ta standard odraža zastavico prevajalnika v repozitoriju, ne pa potrjenega produkcijskega okolja. Vir je razvijajoči se delovni osnutek in lahko vsebuje tudi poznejše funkcije.

Primeri

#include <iostream>
#include <string>
#include <variant>

int main() {
    std::variant<int, std::string> value{42};
    if (const auto* number = std::get_if<int>(&value)) {
        std::cout << *number << '\n';
    }

    value = std::string{"ready"};
    std::cout << value.index() << '\n';
    std::visit([](const auto& item) {
        std::cout << item << '\n';
    }, value);
}

Rezultat

42
1
ready

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri