CKTIS / C++
std::variant — един от фиксиран набор алтернативни типове
std::variant съхранява стойност от един от алтернативните типове, зададени с параметрите на шаблона, и управлява жизнения цикъл на тази стойност. Позволява моделиране на данни като „число или текст“ и безопасна проверка и обработка на активната алтернатива.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#include <variant>
std::variant<Types...> value;
std::get<T>(value);
std::get_if<T>(&value);
std::visit(visitor, value);std::variant<Types...> от <variant> представя затворен набор от алтернативни типове. Съдържаната стойност е вложена в обекта; активна е само една алтернатива в даден момент, с изключение на описаното по-долу състояние без стойност. Конструирането по подразбиране инициализира първата алтернатива със стойност и изисква тя да може да бъде конструирана по подразбиране. Първа алтернатива от тип std::monostate може да представя умишлено празно състояние.
index() връща индекса на активната алтернатива, започващ от нула. std::get<T>(value) връща референция, ако е активна алтернативата от тип T. Функцията хвърля std::bad_variant_access, ако е активна друга алтернатива или ако няма активна алтернатива. std::get_if<T>(&value) връща указател или nullptr, без да хвърля изключение. Достъпът по тип изисква този тип да се среща точно веднъж в списъка с алтернативи; при повторени типове използвайте достъп по индекс, например std::get<0>(value).
std::visit(visitor, value) извиква извикваем обект с активната стойност. Обектът трябва да обработва всяка алтернатива; при показаната форма на извикване всички възможни резултати трябва да имат един и същ тип и категория на стойността. Присвояване или emplace може да промени активната алтернатива. Изключение по време на някои такива операции може да остави обекта без стойност: тогава valueless_by_exception() връща true, index() връща std::variant_npos, а както std::get, така и std::visit хвърлят std::bad_variant_access. Това е различно от съхраняването на std::monostate.
Примерът първо прочита int, след това го заменя със std::string и обработва стойността чрез std::visit. Този запис е предназначен за C++23; посоченият стандарт отразява флага на компилатора в хранилището, а не удостоверена производствена среда. Източникът е развиващ се работен проект и може да включва и по-късни функции.
Примери
#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);
}
Резултат
42 1 ready
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.