WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::get: Zugriff auf Tuple-like- oder Variant-Elemente

std::get wählt ein Element per konstantem Index oder eindeutigem Typ und liefert eine Referenz mit erhaltener Wertkategorie und Constheit.

Version: 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> besitzt Überladungen für std::tuple, std::pair, std::array und std::variant; std::get<T> gilt für Tuple, Pair und Variant, wenn T genau einmal vorkommt. Der nullbasierte Index ist eine Compilezeitkonstante. Das Ergebnis ist eine Referenz: Ein lvalue liefert T& oder const T&, ein rvalue die entsprechende rvalue-Referenz.

Das Beispiel liest Index 0 und den Typ std::string aus dem Tuple und danach std::string aus der aktiven Variant-Alternative. Daher lautet die Ausgabe 7 blue ready. Eine Zuweisung über die Referenz eines nichtkonstanten Tuples ändert das gespeicherte Element; es entsteht keine Kopie.

Ein Index außerhalb des Bereichs oder ein Typ, der nicht genau einmal vorkommt, ist ein Compilezeitfehler. Bei std::variant wirft ein sonst gültiges get<I>/get<T> std::bad_variant_access, wenn eine andere Alternative aktiv ist. Für erwartete Fehlschläge eignen sich std::get_if oder std::holds_alternative. Die Referenz darf das Quellobjekt nicht überleben.

Beispiele

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

Ergebnis

7 blue ready

std::get → 7 blue ready

Quellen