CKTIS / C++
std::tie — n-terica sklicev na obstoječe objekte
std::tie iz glave <tuple> ustvari n-terico lvalue-sklicev na obstoječe objekte. Omogoča prirejanje elementov n-terice spremenljivkam in izpuščanje izbranih mest z std::ignore, ne da bi kopirali sklicevane objekte.
Različica: C++23; repository compiler flag, production runtime not attested
Sintaksa
#include <tuple>
template<class... TTypes>
constexpr std::tuple<TTypes&...> std::tie(TTypes&... t) noexcept;std::tie(t...) vrne std::tuple<TTypes&...>: novo n-terico, ki vsebuje lvalue-sklice na argumente, ne pa kopij njihovih vrednosti. Funkcija je deklarirana kot constexpr in noexcept ter zahteva <tuple>. Že samo ustvarjanje n-terice sklicev argumentov ne spremeni.
Prirejanje tej n-terici zapiše vrednosti v objekte, na katere kažejo njeni elementi; sklicev ne veže znova. Izraz std::tie(count, std::ignore, score) = std::make_tuple(3, 99, 7) nastavi count in score, srednji element pa izpusti. Število elementov se mora ujemati, vsako neizpuščeno prirejanje pa mora biti veljavno za ustrezne tipe. noexcept pri std::tie ne pomeni, da poznejša prirejanja ne morejo sprožiti izjem.
Pri izpeljavi argumentov predloge klic std::tie(42) ni veljaven, ker parametra izpeljanega tipa int& ni mogoče vezati na začasni objekt. Klic std::tie<const int>(42) pa je veljaven, ker je parameter tipa const int& mogoče vezati na začasni objekt. Vrnjena n-terica ne podaljša življenjske dobe tega objekta prek konca polnega izraza, ki vsebuje klic. Sklic je mogoče vezati na objekt const, vendar ga prek tako dobljenega sklica ni mogoče spreminjati. N-terica sklicevanih objektov ne poseduje in jim ne podaljša življenjske dobe; sklicev ne uporabljajte po uničenju teh objektov.
V nasprotju s std::tie std::make_tuple za običajne argumente ustvari elemente, ki shranjujejo vrednosti. V primeru auto refs = std::tie(count, score) kljub uporabi auto še vedno vsebuje sklice. Ko vrednosti razpakiramo, zapis prek std::get<0>(refs) znova spremeni count, zato je pričakovani izpis 5 7.
Primeri
#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';
}
Rezultat
5 7
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.