KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::get: toegang tot tuple-like- of variant-element

std::get kiest een element via constante index of uniek type en retourneert een referentie met behoud van waardecategorie en const.

Versie: C++23

Syntax

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> heeft overloadfamilies voor std::tuple, std::pair, std::array en std::variant; std::get<T> geldt voor tuple, pair en variant als T precies eenmaal voorkomt. De nulgebaseerde index is een compile-timeconstante. Het resultaat is een referentie: een lvalue geeft T& of const T&, een rvalue de bijbehorende rvalue-referentie.

Het voorbeeld leest index 0 en type std::string uit de tuple en daarna std::string uit het actieve variant-alternatief; de uitvoer is 7 blue ready. Toewijzen via de referentie van een niet-const tuple wijzigt het opgeslagen element; er wordt niets gekopieerd.

Een index buiten bereik of een type dat niet precies eenmaal voorkomt is een compile-timefout. Bij std::variant werpt een verder geldige get<I>/get<T> std::bad_variant_access als een ander alternatief actief is. Gebruik bij normale mismatch std::get_if of std::holds_alternative. Bewaar de referentie nooit langer dan het bronobject leeft.

Voorbeelden

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

Resultaat

7 blue ready

std::get → 7 blue ready

Bronnen