CKTIS / C++
std::visit — извикване на функция за активните алтернативи
std::visit от <variant> извиква обект, който може да бъде извикан като функция, като му подава активната стойност на всеки подаден обект от тип std::variant. Ако не е подаден нито един вариант, std::visit(visitor) извиква visitor без аргументи, стига това извикване да е валидно. Алтернативите се избират по време на изпълнение, но валидността на извикването за всяка комбинация от алтернативи се проверява при компилация.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#include <variant>
std::visit(visitor, variants...)
std::visit<R>(visitor, variants...)std::visit(visitor, variants...) от <variant> подава активните стойности на visitor. При няколко варианта подава по една стойност от всеки. Запазва const квалификацията и категорията на стойност на аргументите.
Извикването трябва да е валидно за всяка комбинация от алтернативи, а не само за текущо активната комбинация. Без изрично R всички резултати трябва да имат един и същ тип и категория на стойност. Формата std::visit<R>(visitor, variants...) задава типа на резултата; всяко извикване трябва да удовлетворява изискванията за преобразуване към R, а R = void отхвърля резултата.
Ако някой вариант е в състояние valueless_by_exception(), функцията хвърля std::bad_variant_access. Примерът използва претоварвания на Describe, които връщат std::string. Очакваният изход е int: 42, последван от text: hello, всеки на отделен ред.
Тази статия разглежда свободната функция в C++23. Посоченият адрес води към развиващ се проект на стандарт, а не към окончателен документ за C++23. Задаването на флаг на компилатора не удостоверява работата в производствена среда за изпълнение.
Примери
#include <iostream>
#include <string>
#include <variant>
struct Describe {
std::string operator()(int value) const {
return "int: " + std::to_string(value);
}
std::string operator()(const std::string& value) const {
return "text: " + value;
}
};
int main() {
std::variant<int, std::string> value{42};
std::cout << std::visit(Describe{}, value) << '\n';
value = std::string{"hello"};
std::cout << std::visit(Describe{}, value) << '\n';
}
Резултат
int: 42 text: hello
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.