Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

std::variant — jedan od fiksnog skupa alternativnih tipova

std::variant pohranjuje vrijednost jednog od alternativnih tipova navedenih parametrima predloška i upravlja njezinim životnim vijekom. Omogućuje modeliranje podataka poput „broj ili tekst” te sigurno provjeravanje i obradu aktivne alternative.

Verzija: 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 zatvoren skup alternativnih tipova. Pohranjena je vrijednost unutar objekta; aktivna je samo jedna alternativa odjednom, osim u niže opisanom stanju bez vrijednosti. Zadana konstrukcija inicijalizira prvu alternativu vrijednošću i zahtijeva da se ona može zadano konstruirati. Prva alternativa tipa std::monostate može predstavljati namjerno prazno stanje.

index() vraća indeks aktivne alternative, počevši od nule. std::get<T>(value) vraća referencu ako je aktivna alternativa tipa T. Baca std::bad_variant_access ako je aktivna druga alternativa ili ako nijedna nije aktivna. std::get_if<T>(&value) vraća pokazivač ili nullptr, bez bacanja iznimke. Pristup prema tipu zahtijeva da se taj tip pojavljuje točno jednom na popisu alternativa; za ponovljene tipove koristite pristup prema indeksu, primjerice std::get<0>(value).

std::visit(visitor, value) poziva pozivljiv objekt s aktivnom vrijednošću. Objekt mora obraditi svaku alternativu; u prikazanom obliku poziva svi mogući rezultati moraju imati isti tip i kategoriju vrijednosti. Dodjela ili emplace mogu promijeniti aktivnu alternativu. Iznimka tijekom nekih takvih operacija može ostaviti objekt bez vrijednosti: tada valueless_by_exception() vraća true, index() vraća std::variant_npos, a i std::get i std::visit bacaju std::bad_variant_access. To se razlikuje od pohrane std::monostate.

Primjer najprije čita int, zatim ga zamjenjuje s std::string i obrađuje vrijednost pomoću std::visit. Ovaj je zapis namijenjen za C++23; taj standard odražava oznaku prevoditelja u repozitoriju, a ne potvrđeno produkcijsko okruženje. Izvor je radni nacrt koji se razvija i može sadržavati i kasnije značajke.

Primjeri

#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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori