KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::tuple — een tuple met elementen van vaste typen

std::tuple uit <tuple> groepeert een vast aantal elementen waarvan de typen kunnen verschillen. Met std::get krijg je toegang tot elementen; gestructureerde bindingen geven ze lokale namen.

Versie: 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...> uit <tuple> slaat een vast aantal elementen op. Elk templateargument bepaalt het type van één positie; typen mogen hetzelfde of verschillend zijn. Het aantal en de typen van de posities liggen tijdens het compileren vast, maar de waarden kunnen veranderen als hun typen en kwalificaties dat toestaan.

std::get<I>(t) geeft een verwijzing terug naar het element op de vanaf nul getelde index I. De index moet een compilatieconstante zijn en binnen het bereik vallen; een ongeldige index veroorzaakt een compilatiefout, geen uitzondering. std::get<T>(t) selecteert een element op type, maar vereist dat T precies één keer voorkomt.

In het voorbeeld verandert std::get<0>(item) het eerste element van 3 in 5. De declaratie auto& [count, label] = item; introduceert namen die verwijzen naar de elementen van de oorspronkelijke tuple. Daarentegen zou auto [count, label] = item; in dit voorbeeld een kopie van de tuple maken en de namen aan de elementen daarvan binden.

Het voorbeeld is bedoeld om te worden gecompileerd met -std=c++23. De getoonde code is ongewijzigd uitgevoerd in een geïsoleerde omgeving. Daarbij is vastgesteld dat de standaarduitvoer exact overeenkwam met de opgegeven uitvoer. Daarmee is de uitvoeringsomgeving in productie niet bevestigd. De bron eel.is is een voortdurend veranderend werkdocument, geen bevroren C++23-publicatie; deze uitleg beperkt zich tot functionaliteit die beschikbaar is in C++23.

Voorbeelden

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

Resultaat

5 A

De getoonde code is ongewijzigd uitgevoerd in een geïsoleerde omgeving. De standaarduitvoer kwam exact overeen met de opgegeven uitvoer.

Bronnen