Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::get: přístup k prvku tuple-like nebo variant

std::get vybírá prvek konstantním indexem nebo jednoznačným typem a vrací referenci se zachovanou kategorií hodnoty a const.

Verze: C++23

Syntaxe

template<std::size_t I, class... Types>
constexpr decltype(auto) std::get(std::tuple<Types...>& t); // cv/ref overloads

template<class T, class... Types>
constexpr decltype(auto) std::get(std::tuple<Types...>& t); // cv/ref overloads

// Corresponding overload families exist for std::pair, std::array, and std::variant.

std::get<I> má rodiny přetížení pro std::tuple, std::pair, std::array a std::variant; std::get<T> platí pro tuple, pair a variant, pokud se T vyskytuje právě jednou. Index od nuly je konstantou překladu. Výsledkem je reference: lvalue dává T& nebo const T&, rvalue odpovídající rvalue referenci.

Příklad čte index 0 a typ std::string z tuple a potom std::string z aktivní alternativy variantu, proto vypíše 7 blue ready. Přiřazení přes referenci z nekonstantní tuple by změnilo uložený prvek; kopie nevzniká.

Index mimo rozsah nebo typ, který se nevyskytuje právě jednou, je chyba překladu. U std::variant jinak platné get<I>/get<T> vyhodí std::bad_variant_access, je-li aktivní jiná alternativa. Pro běžné neshody použijte std::get_if nebo std::holds_alternative. Reference nesmí přežít zdrojový objekt.

Příklady

#include <iostream>
#include <string>
#include <tuple>
#include <variant>

int main() {
    std::tuple<int, std::string> row{7, "blue"};
    std::variant<int, std::string> state = std::string{"ready"};

    std::cout << std::get<0>(row) << ' '
              << std::get<std::string>(row) << ' '
              << std::get<std::string>(state) << '\n';
}

Výsledek

7 blue ready

std::get → 7 blue ready

Zdroje