CKTIS / C++
std::tie — n-tica referencií na existujúce objekty
std::tie z hlavičky <tuple> vytvára n-ticu lvalue referencií na existujúce objekty. Umožňuje priraďovať prvky n-tice do premenných a vynechať vybrané pozície pomocou std::ignore bez kopírovania referencovaných objektov.
Verzia: 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...) vracia std::tuple<TTypes&...>: novú n-ticu obsahujúcu lvalue referencie na argumenty, nie kópie ich hodnôt. Funkcia je deklarovaná ako constexpr a noexcept a vyžaduje <tuple>. Samotné vytvorenie n-tice referencií argumenty nemení.
Priradenie do tejto n-tice zapisuje hodnoty do objektov, na ktoré odkazujú jej prvky; referencie znova nepripája. Výraz std::tie(count, std::ignore, score) = std::make_tuple(3, 99, 7) nastaví count a score a vynechá stredný prvok. Počet prvkov sa musí zhodovať a každé nevynechané priradenie musí byť platné pre zodpovedajúce typy. noexcept pri std::tie neznamená, že neskoršie priradenia nemôžu vyvolať výnimky.
Pri odvodzovaní argumentov šablóny nie je volanie std::tie(42) platné, pretože parameter odvodeného typu int& nemožno naviazať na dočasný objekt. Volanie std::tie<const int>(42) je však platné, pretože parameter typu const int& možno naviazať na dočasný objekt. Vrátená n-tica nepredlžuje životnosť tohto objektu za koniec úplného výrazu, ktorý obsahuje volanie. Referenciu možno naviazať na objekt const, ale výsledná referencia ho nemôže meniť. N-tica referencované objekty nevlastní ani nepredlžuje ich životnosť; referencie nepoužívajte po zničení týchto objektov.
Na rozdiel od std::tie vytvára std::make_tuple pre bežné argumenty prvky, ktoré ukladajú hodnoty. V príklade auto refs = std::tie(count, score) stále obsahuje referencie napriek použitiu auto. Po rozbalení hodnôt zápis cez std::get<0>(refs) znova zmení count, takže očakávaný výstup je 5 7.
Príklady
#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';
}
Výsledok
5 7
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.