Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::get: acesso a elemento tuple-like ou variant

std::get seleciona um elemento por índice constante ou tipo único e devolve uma referência que preserva categoria de valor e const.

Versão: C++23

Sintaxe

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> tem famílias de overloads para std::tuple, std::pair, std::array e std::variant; std::get<T> aplica-se a tuple, pair e variant quando T ocorre exatamente uma vez. O índice de base zero é constante de compilação. O resultado é referência: um lvalue produz T& ou const T&, e um rvalue a referência rvalue correspondente.

O exemplo lê o índice 0 e o tipo std::string da tuple, depois std::string da alternativa ativa do variant, imprimindo 7 blue ready. Atribuir pela referência de uma tuple não const alteraria o elemento guardado; não há cópia.

Índice fora do intervalo ou tipo que não ocorra exatamente uma vez é erro de compilação. Num std::variant, um get<I>/get<T> bem formado lança std::bad_variant_access quando outra alternativa está ativa. Se a diferença for fluxo normal, usa std::get_if ou std::holds_alternative. Não guardes a referência além da vida do objeto de origem.

Exemplos

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

Resultado

7 blue ready

std::get → 7 blue ready

Fontes