KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::tie — een tuple van verwijzingen naar bestaande objecten

std::tie uit <tuple> maakt een tuple van lvalue-verwijzingen naar bestaande objecten. Hiermee kun je tuple-elementen aan variabelen toewijzen en geselecteerde posities overslaan met std::ignore, zonder de objecten waarnaar de verwijzingen verwijzen te kopiëren.

Versie: 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...) retourneert std::tuple<TTypes&...>: een nieuwe tuple met lvalue-verwijzingen naar de argumenten, geen kopieën van hun waarden. De functie is gedeclareerd als constexpr en noexcept en vereist <tuple>. Het maken van de tuple met verwijzingen verandert de argumenten op zichzelf niet.

Een toewijzing aan deze tuple schrijft waarden naar de objecten waarnaar de elementen verwijzen; de verwijzingen worden niet opnieuw gebonden. De expressie std::tie(count, std::ignore, score) = std::make_tuple(3, 99, 7) stelt count en score in en slaat het middelste element over. Het aantal elementen moet overeenkomen en elke niet-overgeslagen toewijzing moet geldig zijn voor de bijbehorende typen. Dat std::tie noexcept is, betekent niet dat latere toewijzingen geen uitzonderingen kunnen veroorzaken.

Bij afleiding van templateargumenten is std::tie(42) ongeldig, omdat de parameter van het afgeleide type int& niet aan een tijdelijk object kan worden gebonden. std::tie<const int>(42) is wel geldig, omdat de parameter van het type const int& aan een tijdelijk object kan worden gebonden. De geretourneerde tuple verlengt de levensduur van dat object niet tot voorbij het einde van de volledige expressie waarin de aanroep staat. Een verwijzing kan aan een const-object worden gebonden, maar kan dat object niet wijzigen. De tuple is geen eigenaar van de objecten waarnaar de elementen verwijzen en verlengt hun levensduur niet; gebruik de verwijzingen niet nadat die objecten zijn vernietigd.

In tegenstelling tot std::tie maakt std::make_tuple voor gewone argumenten elementen die waarden opslaan. In het voorbeeld bevat auto refs = std::tie(count, score) ondanks het gebruik van auto nog steeds verwijzingen. Nadat de waarden zijn uitgepakt, verandert schrijven via std::get<0>(refs) count opnieuw; de verwachte uitvoer is dus 5 7.

Voorbeelden

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

Resultaat

5 7

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen