Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::make_tuple — vytvoření n-tice s odvozenými typy

std::make_tuple z <tuple> vytvoří n-tici, jejíž typy prvků se odvodí z argumentů. Obvykle ukládá hodnoty, ale pomocí std::ref a std::cref lze místo kopií vytvořit referenční prvky.

Verze: C++23; repository compiler flag, production runtime not attested

Syntaxe

#include <tuple>
template<class... TTypes>
constexpr std::tuple<std::unwrap_ref_decay_t<TTypes>...>
make_tuple(TTypes&&... t);

std::make_tuple(args...)

std::make_tuple(args...) z <tuple> vytvoří std::tuple, aniž by bylo nutné výslovně uvádět typy jejích prvků. Každý argument inicializuje odpovídající prvek; běžné l-hodnoty se kopírují, zatímco r-hodnoty lze přesunout, pokud to jejich typ umožňuje.

Typ každého prvku určuje std::unwrap_ref_decay_t<TTypes>. Nejprve se odstraní případná reference. Je-li výsledný typ typem pole, vznikne ukazatel na typ jeho prvků se zachováním kvalifikátorů tohoto typu. Jde-li o typ funkce, vznikne ukazatel na funkci tohoto typu. Pouze v ostatních případech se odstraní kvalifikátory const a volatile na nejvyšší úrovni. Běžný řetězcový literál je například pole prvků typu const char, takže prvek n-tice má typ const char*, nikoli char* ani std::string.

Po této transformaci se std::reference_wrapper<T> rozbalí na T&. Použijte std::ref(x), chcete-li zachovat referenci na x, nebo std::cref(x) pro zachování reference na konstantní objekt. N-tice neprodlužuje životnost objektu, na který taková reference odkazuje; tento objekt musí existovat při každém použití reference.

Na rozdíl od std::make_tuple vytváří std::tie n-tici l-hodnotových referencí, zatímco std::forward_as_tuple vytváří n-tici referencí pro předávání argumentů a u dočasných objektů vyžaduje zvláštní opatrnost. V příkladu první prvek uchovává kopii hodnoty 7, kdežto druhý odkazuje na value. Volání std::get<1>(data) pouze vrátí referenci na value. Teprve operace += 1 prostřednictvím této reference zvýší hodnotu value o jedna.

Příklady

#include <functional>
#include <iostream>
#include <tuple>
#include <type_traits>

int main() {
    int value = 7;
    auto data = std::make_tuple(value, std::ref(value));
    static_assert(std::is_same_v<decltype(data), std::tuple<int, int&>>);

    value = 9;
    std::get<1>(data) += 1;
    std::cout << std::get<0>(data) << ' '
              << std::get<1>(data) << ' ' << value << '\n';
}

Výsledek

7 10 10

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.

Zdroje