CKTIS / C++
std::tie — una tupla di riferimenti a oggetti esistenti
std::tie, definita in <tuple>, crea una tupla di riferimenti lvalue a oggetti esistenti. Permette di assegnare gli elementi di una tupla a variabili e di saltare alcune posizioni con std::ignore, senza copiare gli oggetti referenziati.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#include <tuple>
template<class... TTypes>
constexpr std::tuple<TTypes&...> std::tie(TTypes&... t) noexcept;std::tie(t...) restituisce std::tuple<TTypes&...>: una nuova tupla che contiene riferimenti lvalue agli argomenti, non copie dei loro valori. La funzione è dichiarata constexpr e noexcept e richiede <tuple>. La sola creazione della tupla di riferimenti non modifica gli argomenti.
Assegnare a questa tupla scrive valori negli oggetti a cui si riferiscono i suoi elementi; i riferimenti restano legati agli stessi oggetti. L’espressione std::tie(count, std::ignore, score) = std::make_tuple(3, 99, 7) imposta count e score, saltando l’elemento centrale. Il numero di elementi deve corrispondere e ogni assegnazione non ignorata deve essere valida per i tipi corrispondenti. Il fatto che std::tie sia noexcept non significa che le assegnazioni successive non possano generare eccezioni.
Con la deduzione degli argomenti del template, std::tie(42) non è valido perché il parametro di tipo dedotto int& non può legarsi a un oggetto temporaneo. std::tie<const int>(42) è invece valido perché il parametro di tipo const int& può legarsi a un oggetto temporaneo. La tupla restituita non prolunga la durata di quell’oggetto oltre la fine dell’espressione completa che contiene la chiamata. È possibile legare un riferimento a un oggetto const, ma il riferimento risultante non consente di modificarlo. La tupla non possiede gli oggetti referenziati e non ne prolunga la durata; non usare i suoi riferimenti dopo la distruzione di tali oggetti.
A differenza di std::tie, std::make_tuple crea elementi che memorizzano valori per gli argomenti ordinari. Nell’esempio, auto refs = std::tie(count, score) contiene ancora riferimenti nonostante l’uso di auto. Dopo aver estratto i valori, scrivere tramite std::get<0>(refs) modifica di nuovo count; l’output previsto è quindi 5 7.
Esempi
#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';
}
Risultato
5 7
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.