Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti