Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::visit — volanie funkčného objektu pre aktívne alternatívy

std::visit z hlavičky <variant> volá volateľný objekt s aktívnou hodnotou každého odovzdaného objektu std::variant. Ak sa neodovzdá žiadny variant, std::visit(visitor) zavolá visitor bez argumentov, pokiaľ je také volanie platné. Alternatívy sa vyberajú za behu, ale platnosť volania pre každú kombináciu alternatív sa kontroluje pri preklade.

Verzia: C++23; repository compiler flag, production runtime not attested

Syntax

#include <variant>
std::visit(visitor, variants...)
std::visit<R>(visitor, variants...)

std::visit(visitor, variants...) z <variant> odovzdá aktívne hodnoty objektu visitor. Pri viacerých variantoch odovzdá jednu hodnotu z každého. Zachováva kvalifikáciu const a kategóriu hodnôt argumentov.

Volanie musí byť platné pre každú kombináciu alternatív, nielen pre práve aktívnu kombináciu. Bez výslovného R musia mať všetky výsledky rovnaký typ aj kategóriu hodnôt. Tvar std::visit<R>(visitor, variants...) určuje typ výsledku; každé volanie musí spĺňať požiadavky na konverziu na R, zatiaľ čo R = void výsledok zahodí.

Ak je niektorý variant v stave valueless_by_exception(), funkcia vyvolá std::bad_variant_access. Príklad používa preťaženia Describe, ktoré vracajú std::string. Očakávaný výstup je int: 42 a potom text: hello, každý na samostatnom riadku.

Tento záznam sa týka voľnej funkcie v C++23. Uvedená adresa odkazuje na priebežne sa vyvíjajúci návrh štandardu, nie na nemenný dokument C++23. Nastavenie príznaku kompilátora nepotvrdzuje fungovanie v produkčnom runtime prostredí.

Príklady

#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';
}

Výsledok

int: 42
text: hello

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje