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.