tuple – třída
Zabalí sekvenci prvků s pevnou délkou.
Syntaxe
class tuple {
tuple();
explicit tuple(P1, P2, ..., PN); // 0 < N
tuple(const tuple&);
template <class U1, class U2, ..., class UN>
tuple(const tuple<U1, U2, ..., UN>&);
template <class U1, class U2>
tuple(const pair<U1, U2>&); // N == 2
void swap(tuple& right);
tuple& operator=(const tuple&);
template <class U1, class U2, ..., class UN>
tuple& operator=(const tuple<U1, U2, ..., UN>&);
template <class U1, class U2>
tuple& operator=(const pair<U1, U2>&); // N == 2
};
Parametry
TN
Typ prvku Nth řazené kolekce členů.
Poznámky
Šablona třídy popisuje objekt, který ukládá N objekty typů T1, T2, ... , TNv uvedeném pořadí, kde 0 <= N <= Nmax. Rozsah instance tuple<T1, T2, ..., TN> řazené kolekce členů je počet N argumentů šablony. Index argumentu Ti šablony a odpovídající uložené hodnoty tohoto typu je i - 1. Zatímco v této dokumentaci očíslujeme typy od 1 do N, odpovídající hodnoty indexu jsou v rozsahu od 0 do N až 1.
Příklad
// tuple.cpp
// compile with: /EHsc
#include <vector>
#include <iomanip>
#include <iostream>
#include <tuple>
#include <string>
using namespace std;
typedef tuple <int, double, string> ids;
void print_ids(const ids& i)
{
cout << "( "
<< get<0>(i) << ", "
<< get<1>(i) << ", "
<< get<2>(i) << " )." << endl;
}
int main( )
{
// Using the constructor to declare and initialize a tuple
ids p1(10, 1.1e-2, "one");
// Compare using the helper function to declare and initialize a tuple
ids p2;
p2 = make_tuple(10, 2.22e-1, "two");
// Making a copy of a tuple
ids p3(p1);
cout.precision(3);
cout << "The tuple p1 is: ( ";
print_ids(p1);
cout << "The tuple p2 is: ( ";
print_ids(p2);
cout << "The tuple p3 is: ( ";
print_ids(p3);
vector<ids> v;
v.push_back(p1);
v.push_back(p2);
v.push_back(make_tuple(3, 3.3e-2, "three"));
cout << "The tuples in the vector are" << endl;
for(vector<ids>::const_iterator i = v.begin(); i != v.end(); ++i)
{
print_ids(*i);
}
}
The tuple p1 is: ( 10, 0.011, one ).
The tuple p2 is: ( 10, 0.222, two ).
The tuple p3 is: ( 10, 0.011, one ).
The tuples in the vector are
( 10, 0.011, one ).
( 10, 0.222, two ).
( 3, 0.033, three ).
operator=
tuple Přiřadí objekt.
tuple& operator=(const tuple& right);
template <class U1, class U2, ..., class UN>
tuple& operator=(const tuple<U1, U2, ..., UN>& right);
template <class U1, class U2>
tuple& operator=(const pair<U1, U2>& right); // N == 2
tuple& operator=(tuple&& right);
template <class U1, class U2>
tuple& operator=(pair<U1, U2>&& right);
Parametry
OSN
Typ prvku řazené kolekce členů Nth.
Vpravo
Řazená kolekce členů, ze které chcete kopírovat.
Poznámky
První dva operátory členů přiřazují prvky práva k odpovídajícím prvkům .*this Operátor třetího členu přiřadí right.first elementu na indexu 0 *this a right.second elementu v indexu 1. Vrátí všechny tři členské operátory *this.
Zbývající členské operátory jsou analogické k dřívějším operátorům, ale s deklarátorem odkazu Rvalue: &>.
Příklad
// std__tuple__tuple_operator_as.cpp
// compile with: /EHsc
#include <tuple>
#include <iostream>
#include <utility>
typedef std::tuple<int, double, int, double> Mytuple;
int main()
{
Mytuple c0(0, 1, 2, 3);
// display contents " 0 1 2 3"
std::cout << " " << std::get<0>(c0);
std::cout << " " << std::get<1>(c0);
std::cout << " " << std::get<2>(c0);
std::cout << " " << std::get<3>(c0);
std::cout << std::endl;
Mytuple c1;
c1 = c0;
// display contents " 0 1 2 3"
std::cout << " " << std::get<0>(c1);
std::cout << " " << std::get<1>(c1);
std::cout << " " << std::get<2>(c1);
std::cout << " " << std::get<3>(c1);
std::cout << std::endl;
std::tuple<char, int> c2;
c2 = std::make_pair('x', 4);
// display contents " x 4"
std::cout << " " << std::get<0>(c2);
std::cout << " " << std::get<1>(c2);
std::cout << std::endl;
return (0);
}
0 1 2 3
0 1 2 3
x 4
swap
Vymění prvky dvou řazených kolekcí členů.
template <class... Types>
void swap(tuple<Types...&> left, tuple<Types...&> right);
Parametry
Vlevo
Řazená kolekce členů, jejíž prvky se mají vyměňovat s řazenými kolekcemi členů vpravo.
Vpravo
Řazená kolekce členů, jejíž prvky se mají vyměňovat s řazenými kolekcemi členů zleva.
Poznámky
Funkce se spustí left.swap(right).
tuple
tuple Vytvoří objekt.
constexpr tuple();
explicit constexpr tuple(const Types&...);
template <class... UTypes>
explicit constexpr tuple(UTypes&&...);
tuple(const tuple&) = default;
tuple(tuple&&) = default;
template <class... UTypes>
constexpr tuple(const tuple<UTypes...>&);
template <class... UTypes>
constexpr tuple(tuple<UTypes...>&&);
// only if sizeof...(Types) == 2
template <class U1, class U2>
constexpr tuple(const pair<U1, U2>&);
template <class U1, class U2>
constexpr tuple(pair<U1, U2>&&);
Parametry
OSN
Typ prvku řazené kolekce členů Nth.
Vpravo
Řazená kolekce členů, ze které chcete kopírovat.
Poznámky
První konstruktor vytvoří objekt, jehož prvky jsou výchozí vytvořené.
Druhý konstruktor vytvoří objekt, jehož prvky jsou zkopírovány z argumentů P1, P2, ..., PN s každou Pi inicializací prvku v indexu i - 1.
Třetí a čtvrté konstruktory vytvářejí objekt, jehož prvky jsou zkopírovány z odpovídajícího prvku vpravo.
Pátý konstruktor vytvoří objekt, jehož prvek indexu 0 je vytvořen z right.first a jehož prvek indexu 1 je zkopírován z right.second.
Zbývající konstruktory jsou analogické k dřívějším konstruktorům, ale s deklarátorem odkazu Rvalue: &>.
Příklad
// std__tuple__tuple_tuple.cpp
// compile with: /EHsc
#include <tuple>
#include <iostream>
#include <utility>
typedef std::tuple<int, double, int, double> Mytuple;
int main()
{
Mytuple c0(0, 1, 2, 3);
// display contents "0 1 2 3"
std::cout << std::get<0>(c0) << " ";
std::cout << std::get<1>(c0) << " ";
std::cout << std::get<2>(c0) << " ";
std::cout << std::get<3>(c0);
std::cout << std::endl;
Mytuple c1;
c1 = c0;
// display contents "0 1 2 3"
std::cout << std::get<0>(c1) << " ";
std::cout << std::get<1>(c1) << " ";
std::cout << std::get<2>(c1) << " ";
std::cout << std::get<3>(c1);
std::cout << std::endl;
std::tuple<char, int> c2(std::make_pair('x', 4));
// display contents "x 4"
std::cout << std::get<0>(c2) << " ";
std::cout << std::get<1>(c2);
std::cout << std::endl;
Mytuple c3(c0);
// display contents "0 1 2 3"
std::cout << std::get<0>(c3) << " ";
std::cout << std::get<1>(c3) << " ";
std::cout << std::get<2>(c3) << " ";
std::cout << std::get<3>(c3);
std::cout << std::endl;
typedef std::tuple<int, float, int, float> Mytuple2;
Mytuple c4(Mytuple2(4, 5, 6, 7));
// display contents "4 5 6 7"
std::cout << std::get<0>(c4) << " ";
std::cout << std::get<1>(c4) << " ";
std::cout << std::get<2>(c4) << " ";
std::cout << std::get<3>(c4);
std::cout << std::endl;
return (0);
}
0 1 2 3
0 1 2 3
x 4
0 1 2 3
4 5 6 7