WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::tie — ein Tupel aus Referenzen auf vorhandene Objekte

std::tie aus <tuple> erstellt ein Tupel aus lvalue-Referenzen auf vorhandene Objekte. Damit lassen sich Tupelwerte Variablen zuweisen und ausgewählte Positionen mit std::ignore überspringen, ohne die referenzierten Objekte zu kopieren.

Version: C++23; repository compiler flag, production runtime not attested

Syntax

#include <tuple>

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

std::tie(t...) gibt std::tuple<TTypes&...> zurück: ein neues Tupel mit lvalue-Referenzen auf die Argumente, nicht mit Kopien ihrer Werte. Die Funktion ist als constexpr und noexcept deklariert und benötigt <tuple>. Das Erstellen des Referenztupels allein ändert die Argumente nicht.

Eine Zuweisung an dieses Tupel schreibt Werte in die Objekte, auf die seine Elemente verweisen; sie bindet die Referenzen nicht neu. Der Ausdruck std::tie(count, std::ignore, score) = std::make_tuple(3, 99, 7) setzt count und score und überspringt das mittlere Element. Die Anzahl der Elemente muss übereinstimmen, und jede nicht übersprungene Zuweisung muss für die jeweiligen Typen gültig sein. Das noexcept von std::tie bedeutet nicht, dass spätere Zuweisungen keine Ausnahmen auslösen können.

Bei der Ableitung der Template-Argumente ist std::tie(42) ungültig, weil sich der Parameter des abgeleiteten Typs int& nicht an ein temporäres Objekt binden lässt. std::tie<const int>(42) ist dagegen gültig, weil sich der Parameter vom Typ const int& an ein temporäres Objekt binden lässt. Das zurückgegebene Tupel verlängert die Lebensdauer dieses Objekts nicht über das Ende des vollständigen Ausdrucks hinaus, der den Aufruf enthält. Ein const-Objekt kann gebunden werden, aber die resultierende Referenz kann es nicht ändern. Das Tupel besitzt die referenzierten Objekte nicht und verlängert ihre Lebensdauer nicht; verwende die Referenzen nicht mehr, nachdem diese Objekte zerstört wurden.

Im Gegensatz zu std::tie erstellt std::make_tuple für gewöhnliche Argumente Elemente, die Werte speichern. Im Beispiel enthält auto refs = std::tie(count, score) trotz der Verwendung von auto weiterhin Referenzen. Nachdem die Werte entpackt wurden, ändert das Schreiben über std::get<0>(refs) count erneut; die erwartete Ausgabe lautet daher 5 7.

Beispiele

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

Ergebnis

5 7

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen