WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::make_tuple — Tupel mit abgeleiteten Typen erstellen

std::make_tuple aus <tuple> erstellt ein Tupel, dessen Elementtypen aus den Argumenten abgeleitet werden. Normalerweise speichert es Werte; mit std::ref und std::cref lassen sich stattdessen Referenzelemente erzeugen.

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

Syntax

#include <tuple>
template<class... TTypes>
constexpr std::tuple<std::unwrap_ref_decay_t<TTypes>...>
make_tuple(TTypes&&... t);

std::make_tuple(args...)

std::make_tuple(args...) aus <tuple> erstellt ein std::tuple, ohne dass die Elementtypen ausdrücklich angegeben werden müssen. Jedes Argument initialisiert das entsprechende Element; gewöhnliche Lvalues werden kopiert, während Rvalues verschoben werden können, sofern ihr Typ dies unterstützt.

Der Typ jedes Elements wird durch std::unwrap_ref_decay_t<TTypes> bestimmt. Zunächst wird eine etwaige Referenz entfernt. Ist der verbleibende Typ ein Arraytyp, ergibt sich ein Zeiger auf den Elementtyp des Arrays, dessen Qualifizierer erhalten bleiben. Bei einem Funktionstyp ergibt sich ein Zeiger auf eine Funktion dieses Typs. Nur in den übrigen Fällen werden die const- und volatile-Qualifizierer auf oberster Ebene entfernt. Ein gewöhnliches Zeichenkettenliteral ist beispielsweise ein Array aus const char. Das Tupelelement hat daher den Typ const char*, nicht char* oder std::string.

Nach dieser Umwandlung wird std::reference_wrapper<T> zu T& entpackt. Verwende std::ref(x), um eine Referenz auf x zu erhalten, oder std::cref(x), um eine Referenz auf ein konstantes Objekt zu erhalten. Das Tupel verlängert die Lebensdauer des Objekts, auf das eine solche Referenz verweist, nicht; das Objekt muss bei jeder Verwendung der Referenz weiterhin existieren.

Anders als std::make_tuple erstellt std::tie ein Tupel aus Lvalue-Referenzen. std::forward_as_tuple erstellt ein Tupel aus Referenzen zum Weiterleiten von Argumenten und erfordert bei temporären Objekten besondere Vorsicht. Im Beispiel enthält das erste Element eine Kopie von 7, während sich das zweite auf value bezieht. Der Aufruf std::get<1>(data) gibt lediglich eine Referenz auf value zurück. Erst die Operation += 1 erhöht value über diese Referenz um eins.

Beispiele

#include <functional>
#include <iostream>
#include <tuple>
#include <type_traits>

int main() {
    int value = 7;
    auto data = std::make_tuple(value, std::ref(value));
    static_assert(std::is_same_v<decltype(data), std::tuple<int, int&>>);

    value = 9;
    std::get<1>(data) += 1;
    std::cout << std::get<0>(data) << ' '
              << std::get<1>(data) << ' ' << value << '\n';
}

Ergebnis

7 10 10

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