CKTIS / C++
std::tie — n-tice referencí na existující objekty
std::tie z hlavičky <tuple> vytváří n-tici lvalue referencí na existující objekty. Umožňuje přiřazovat prvky n-tice do proměnných a vynechávat vybrané pozice pomocí std::ignore, aniž by se referencované objekty kopírovaly.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <tuple>
template<class... TTypes>
constexpr std::tuple<TTypes&...> std::tie(TTypes&... t) noexcept;std::tie(t...) vrací std::tuple<TTypes&...>: novou n-tici obsahující lvalue reference na argumenty, nikoli kopie jejich hodnot. Funkce je deklarována jako constexpr a noexcept a vyžaduje <tuple>. Samotné vytvoření n-tice referencí argumenty nemění.
Přiřazení do této n-tice zapisuje hodnoty do objektů, na které odkazují její prvky; reference znovu nepřipojuje. Výraz std::tie(count, std::ignore, score) = std::make_tuple(3, 99, 7) nastaví count a score a prostřední prvek vynechá. Počet prvků se musí shodovat a každé nevynechané přiřazení musí být platné pro odpovídající typy. noexcept u std::tie neznamená, že pozdější přiřazení nemohou vyvolat výjimky.
Při odvozování argumentů šablony není volání std::tie(42) platné, protože parametr odvozeného typu int& nelze navázat na dočasný objekt. Volání std::tie<const int>(42) je však platné, protože parametr typu const int& lze navázat na dočasný objekt. Vrácená n-tice neprodlužuje životnost tohoto objektu za konec úplného výrazu, který volání obsahuje. Referenci lze navázat na objekt const, ale výsledná reference jej nemůže měnit. N-tice referencované objekty nevlastní ani neprodlužuje jejich životnost; reference nepoužívejte po zničení těchto objektů.
Na rozdíl od std::tie vytváří std::make_tuple pro běžné argumenty prvky ukládající hodnoty. V příkladu auto refs = std::tie(count, score) stále obsahuje reference, i když se používá auto. Po rozbalení hodnot zápis přes std::get<0>(refs) znovu změní count, takže očekávaný výstup je 5 7.
Pří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ýsledek
5 7
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.