База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници