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

CKTIS / C++

std::tie — um tuplo de referências para objetos existentes

std::tie, de <tuple>, cria um tuplo de referências lvalue para objetos existentes. Permite atribuir elementos de um tuplo a variáveis e ignorar posições selecionadas com std::ignore, sem copiar os objetos referenciados.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#include <tuple>

template<class... TTypes>
constexpr std::tuple<TTypes&...> std::tie(TTypes&... t) noexcept;

std::tie(t...) devolve std::tuple<TTypes&...>: um novo tuplo que contém referências lvalue para os argumentos, não cópias dos respetivos valores. A função é declarada constexpr e noexcept e requer <tuple>. A criação do tuplo de referências, por si só, não altera os argumentos.

A atribuição a este tuplo escreve valores nos objetos referenciados pelos seus elementos; não volta a associar as referências. A expressão std::tie(count, std::ignore, score) = std::make_tuple(3, 99, 7) define count e score, ignorando o elemento central. O número de elementos tem de corresponder, e cada atribuição não ignorada tem de ser válida para os tipos correspondentes. O noexcept de std::tie não significa que as atribuições posteriores não possam lançar exceções.

Com a dedução dos argumentos do modelo, std::tie(42) é inválido porque o parâmetro de tipo deduzido int& não pode ser associado a um objeto temporário. Já std::tie<const int>(42) é válido porque o parâmetro do tipo const int& pode ser associado a um objeto temporário. O tuplo devolvido não prolonga o tempo de vida desse objeto para além do fim da expressão completa que contém a chamada. É possível associar uma referência a um objeto const, mas a referência resultante não permite modificá-lo. O tuplo não é proprietário dos objetos referenciados nem prolonga o seu tempo de vida; não utilize as referências depois de esses objetos serem destruídos.

Ao contrário de std::tie, std::make_tuple cria elementos que armazenam valores para argumentos comuns. No exemplo, auto refs = std::tie(count, score) continua a conter referências apesar de usar auto. Depois de extrair os valores, escrever através de std::get<0>(refs) altera novamente count, pelo que o resultado esperado é 5 7.

Exemplos

#include <iostream>
#include <tuple>

int main() {
    int count = 0;
    int score = 0;
    auto refs = std::tie(count, score);

    std::tie(count, std::ignore, score) = std::make_tuple(3, 99, 7);
    std::get<0>(refs) = 5;

    std::cout << count << ' ' << score << '\n';
}

Resultado

5 7

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes