Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::get: dostęp do elementu tuple-like lub wariantu

std::get wybiera element przez stały indeks albo jednoznaczny typ i zwraca referencję zachowującą kategorię wartości oraz const.

Wersja: C++23

Składnia

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> ma rodziny przeciążeń dla std::tuple, std::pair, std::array i std::variant; std::get<T> działa dla tuple, pair i variant, gdy T występuje dokładnie raz. Indeks jest liczony od zera i musi być stałą czasu kompilacji. Wynik jest referencją: lvalue daje T& lub const T&, a rvalue odpowiednią referencję rvalue.

Przykład pobiera indeks 0 i typ std::string z tuple, a potem std::string z aktywnej alternatywy wariantu, dlatego wypisuje 7 blue ready. Modyfikacja przez referencję zwróconą z nieconst tuple zmieniłaby przechowywany element; nie powstaje kopia.

Indeks poza zakresem albo wybór typu, który nie występuje dokładnie raz, jest błędem kompilacji. Dla std::variant poprawnie sformułowane get<I>/get<T> rzuca std::bad_variant_access, jeśli aktywna jest inna alternatywa. Gdy niedopasowanie jest normalnym przepływem, użyj std::get_if lub std::holds_alternative; nie przechowuj zwróconej referencji dłużej niż żyje obiekt.

Przykłady

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

Wynik

7 blue ready

std::get → 7 blue ready

Źródła