WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::tuple — ein Tupel mit festgelegten Elementtypen

std::tuple aus <tuple> gruppiert eine feste Anzahl von Elementen, deren Typen unterschiedlich sein können. Mit std::get greifst du auf Elemente zu; strukturierte Bindungen geben ihnen lokale Namen.

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

Syntax

#include <tuple>
std::tuple<Types...> name{values...};
std::get<I>(name);
std::get<T>(name);

std::tuple<Types...> aus <tuple> speichert eine feste Anzahl von Elementen. Jedes Template-Argument legt den Typ einer Position fest; Typen können sich wiederholen oder unterscheiden. Anzahl und Typen der Positionen stehen zur Compile-Zeit fest, die Werte können sich jedoch ändern, sofern ihre Typen und Qualifizierer dies zulassen.

std::get<I>(t) gibt eine Referenz auf das Element am nullbasierten Index I zurück. Der Index muss eine Compile-Zeit-Konstante innerhalb des gültigen Bereichs sein; ein ungültiger Index führt zu einem Kompilierungsfehler, nicht zu einer Ausnahme. std::get<T>(t) wählt ein Element anhand seines Typs aus, setzt aber voraus, dass T genau einmal vorkommt.

Im Beispiel ändert std::get<0>(item) das erste Element von 3 zu 5. Die Deklaration auto& [count, label] = item; führt Namen ein, die sich auf die Elemente des ursprünglichen Tupels beziehen. Dagegen würde auto [count, label] = item; in diesem Beispiel eine Kopie des Tupels erstellen und die Namen an deren Elemente binden.

Das Beispiel ist für die Kompilierung mit -std=c++23 vorgesehen. Der gezeigte Code wurde unverändert in einer isolierten Umgebung ausgeführt. Dabei wurde bestätigt, dass die Standardausgabe exakt mit der angegebenen Ausgabe übereinstimmt. Die Laufzeitumgebung im Produktivbetrieb ist damit nicht bestätigt. Die Quelle eel.is ist ein fortlaufend weiterentwickelter Arbeitsentwurf und keine unveränderliche C++23-Veröffentlichung; diese Erläuterung beschränkt sich auf Funktionen, die in C++23 verfügbar sind.

Beispiele

#include <iostream>
#include <tuple>

int main() {
    std::tuple<int, char> item{3, 'A'};
    std::get<0>(item) += 2;
    auto& [count, label] = item;
    std::cout << count << ' ' << label << '\n';
}

Ergebnis

5 A

Der gezeigte Code wurde unverändert in einer isolierten Umgebung ausgeführt. Die Standardausgabe stimmte exakt mit der angegebenen Ausgabe überein.

Quellen