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

CKTIS / C++

std::tuple — n-tice prvků s pevně danými typy

std::tuple z <tuple> sdružuje pevný počet prvků, jejichž typy se mohou lišit. K přístupu slouží std::get a strukturované vazby umožňují dát prvkům místní názvy.

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

Syntaxe

#include <tuple>
std::tuple<Types...> name{values...};
std::get<I>(name);
std::get<T>(name);

std::tuple<Types...> z <tuple> ukládá pevný počet prvků. Každý argument šablony určuje typ jedné pozice; typy se mohou opakovat nebo lišit. Počet i typy pozic jsou určeny při kompilaci, ale hodnoty se mohou měnit, pokud to jejich typy a kvalifikátory dovolují.

std::get<I>(t) vrací referenci na prvek s indexem I, který se počítá od nuly. Index musí být konstantou známou při kompilaci a musí být v platném rozsahu; neplatný index způsobí chybu kompilace, nikoli výjimku. std::get<T>(t) vybírá prvek podle typu, ale vyžaduje, aby se T vyskytoval právě jednou.

V příkladu std::get<0>(item) změní první prvek z 3 na 5. Deklarace auto& [count, label] = item; zavede názvy, které odkazují na prvky původní n-tice. Naproti tomu auto [count, label] = item; by v tomto příkladu vytvořilo kopii n-tice a navázalo názvy na její prvky.

Příklad je určen ke kompilaci s -std=c++23. Zobrazený kód byl spuštěn beze změn v izolovaném prostředí a ověřilo se, že standardní výstup přesně odpovídal uvedenému výstupu. Toto ověření nepotvrzuje produkční běhové prostředí. Zdroj eel.is je průběžně se vyvíjející pracovní návrh, nikoli neměnné vydání C++23; tento popis se omezuje na funkce dostupné v C++23.

Příklady

#include <iostream>
#include <tuple>

int main() {
    std::tuple<int, char> item{3, 'A'};
    std::get<0>(item) += 2;
    auto& [count, label] = item;
    std::cout << count << ' ' << label << '\n';
}

Výsledek

5 A

Zobrazený kód byl spuštěn beze změn v izolovaném prostředí. Standardní výstup přesně odpovídal uvedenému výstupu.

Zdroje