Namespaces
Variants

    std::tuple_cat

    Von de.cppreference.net
     
    C++
     
    Dienstprogrammbibliothek
    Sprachunterstützung
    Typunterstützung (Basistypen, RTTI)
    Bibliotheks-Feature-Test-Makros (C++20)
    Programm-Dienstprogramme
    Variadische Funktionen
    (C++11)
    (C++20)
    (C++26)
    (C++20)
    Koroutinen-Unterstützung (C++20)
    Vertragsunterstützung (C++26)
    Dreiseitiger Vergleich
    (C++20)(C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)    
    (C++20)(C++20)(C++20)    
    (C++20)(C++20)(C++20)

    Allgemeine Dienstprogramme
    Relationale Operatoren (veraltet in C++20)
    Integer-Vergleichsfunktionen
    (C++20)(C++20)(C++20)    
    (C++20)
    Tausch und Typ-Operationen
    (C++20)
    (C++14)
    (C++11)
    (C++23)
    (C++11)
    (C++23)
    (C++11)
    (C++11)
    (C++17)
    Allgemeine Vokabular-Typen
    (C++11)
    (C++17)
    (C++17)
    (C++17)
    (C++11)
    (C++11)
    (C++17)
    (C++17)
    (C++23)



     
    std::tuple
     
    Definiert in Header <tuple> 
    template< class... Tuples >
std::tuple</* CTypes */...> tuple_cat( Tuples&&... args );
    		(seit C++11)
    (bis C++14)    		 
    template< class... Tuples >
constexpr std::tuple</* CTypes */...> tuple_cat( Tuples&&... args );
    		(seit C++14)
    (bis C++23)    		 
    template< tuple-like... Tuples >
constexpr std::tuple</* CTypes */...> tuple_cat( Tuples&&... args );
    		(seit C++23)

    Konstruiert ein tuple, das eine Verkettung aller tuples in args ist. Die Elementtypen /* CTypes */ des zurückgegebenen tuple werden gebildet, indem die Elementtypenpakete aller std::tuple(bis C++23)tuple-like(seit C++23) Typen in Tuples der Reihe nach verkettet werden.

    Das Verhalten ist undefiniert, wenn irgendein Typ in std::decay_t<Tuples>... keine Spezialisierung von std::tuple ist. Eine Implementierung kann jedoch wählen, Typen (wie std::array und std::pair) zu unterstützen, die dem tuple-ähnlichen Protokoll folgen.

    		(bis C++23)

    Die Typen std::decay_t<Tuples>... sind auf tuple-ähnlich eingeschränkt, d.h. jeder darin enthaltene Typ muss eine Spezialisierung von std::tuple oder ein anderer Typ (wie std::array und std::pair) sein, der tuple-like modelliert.

    		(seit C++23)

    Wenn irgendein Typ in /* CTypes */ nicht aus dem Typ des entsprechenden Elements in der Sequenz von Elementen konstruierbar ist, die aus args verkettet wurden, dann ist das Verhalten undefiniert(bis C++23)ist das Programm fehlerhaft(seit C++23).

    Parameter

    args - null oder mehrere Tupel zum Verketten

    Rückgabewert

    Ein std::tuple -Objekt, das aus allen Elementen aller Argument-Tupel zusammengesetzt ist, konstruiert aus std :: get < j > ( std:: forward < Ti > ( arg ) ) für jedes einzelne Element.

    Beispiel

    Diesen Code ausführen 
    #include <iostream>
#include <string>
#include <tuple>
// Hilfsfunktion zur Ausgabe eines Tupels beliebiger Größe
template<class Tuple, std::size_t N>
struct TuplePrinter
{
    static void print(const Tuple& t)
    {
        TuplePrinter<Tuple, N - 1>::print(t);
        std::cout << ", " << std::get<N-1>(t);
    }
};
template<class Tuple>
struct TuplePrinter<Tuple, 1>
{
    static void print(const Tuple& t)
    {
        std::cout << std::get<0>(t);
    }
};
template<typename... Args, std::enable_if_t<sizeof...(Args) == 0, int> = 0>
void print(const std::tuple<Args...>& t)
{
    std::cout << "()\n";
}
template<typename... Args, std::enable_if_t<sizeof...(Args) != 0, int> = 0>
void print(const std::tuple<Args...>& t)
{
    std::cout << "(";
    TuplePrinter<decltype(t), sizeof...(Args)>::print(t);
    std::cout << ")\n";
}
// Ende der Hilfsfunktion
int main()
{
    std::tuple<int, std::string, float> t1(10, "Test", 3.14);
    int n = 7;
    auto t2 = std::tuple_cat(t1, std::make_tuple("Foo", "bar"), t1, std::tie(n));
    n = 42;
    print(t2);
}

    Ausgabe: 

    (10, Test, 3.14, Foo, bar, 10, Test, 3.14, 42)

    Siehe auch

    (C++11)
    		erstellt ein tuple -Objekt des durch die Argumenttypen definierten Typs
    (Funktions-Template)
    (C++11)
    		erstellt ein tuple von Lvalue-Referenzen oder entpackt ein Tupel in einzelne Objekte
    (Funktions-Template)
    (C++11)
    		erstellt ein tuple von Forwarding-Referenzen
    (Funktions-Template)