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

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

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

Източници