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.