std::tuple

 

C++

Język

Nagłówki biblioteki standardowej

Koncepty

Biblioteka narzędzi

Biblioteka string

Biblioteka kontenerów

Biblioteka algorytmów

Biblioteka iteratorów

Biblioteka numeryczna

Biblioteka wejścia/wyjścia

Biblioteka lokalizacji

Biblioteka wyrażeń regularnych(C++11)

Biblioteka operacji atomowych(C++11)

Biblioteka obsługi wątków(C++11)

 

Biblioteka narzędzi

Wsparcie dla typów (basic types, RTTI, type traits)

Dynamiczne zarządzanie pamięcią

Obsługa błędów

Program utilities

Funkcje o zmiennej liczbie argumentów

Data i czas

Obiekty funkcyjne

initializer_list (C++11)

bitset

hash (C++11)

Operatory relacyjne

rel_ops::operator!=rel_ops::operator>rel_ops::operator<=rel_ops::operator>=

Pary i krotki

pair

tuple (C++11)

piecewise_construct_t (C++11)

piecewise_construct (C++11)

Swap, forward i move

swap

forward (C++11)

move (C++11)

move_if_noexcept (C++11)

 

std::tuple

Metody

tuple::tuple

tuple::operator=

tuple::swap

Funkcje zewnętrzne

make_tuple

tie

forward_as_tuple

tuple_cat

operator==operator!=operator<operator<=operator>operator>=

std::swap

get

Klasy pomocnicze

tuple_size

tuple_element

uses_allocator

ignore

 

Zdefiniowane w nagłówku <tuple>
template<class... Types> class tuple;		(od C++11)

Szablon klasy std::tuple (krotka) jest kolekcją o stałym rozmiarze, przechowującą heterogeniczne wartości. Jest to generalizacja pary std::pair.

Jeśli (std::is_trivially_destructible_v<Types>&& ...) jest true, to destruktor tuple jest trywialny.

(od C++17)

Parametry szablonu

Types...

-

typy elementów, które będzie przechowywała krotka. Lista nie może być pusta.

Metody

(constructor)	konstruuje nową krotkę tuple (publiczna metoda)
operator=	przypisuje wartość jednej krotki tuple do drugiej (publiczna metoda)
swap	zamienia ze sobą zawartość dwóch krotek (publiczna metoda)

Funkcje zewnętrzne

make_tuple	tworzy obiekt krotki tuple o typach elementów definiowanych typami argumentów (szablon funkcji)
tie	tworzy krotkę tuple referencji lvalue lub rozpakowuje krotkę do pojedynczych obiektów (szablon funkcji)
forward_as_tuple	tworzy tuple jako referencje do r-wartości(rvalue references) (szablon funkcji)
tuple_cat	tworzy tuple przez połączenie dowolnej ilości tuple(konkatenacja) (szablon funkcji)
std::get(std::tuple)	dostęp do określonego elementu krotki (szablon funkcji)
operator==operator!=operator<operator<=operator>operator>=	porównanie leksykograficzne wartości w tuple (szablon funkcji)
std::swap(std::tuple) (C++11)	przystosowanie algorytmu std::swap (szablon funkcji)

Klasy pomocnicze

tuple_size	uzyskuje rozmiar krotki tuple w czasie kompilacji (specjalizacja szablonu klasy)
tuple_element	uzyskuje typ określonego elementu krotki (specjalizacja szablonu klasy)
std::uses_allocator<std::tuple> (C++11)	przystosowanie std::uses_allocator (specjalizacja szablonu klasy)
ignore	symbol zastępczy, aby pominąć element podczas rozpakowywania tuple za pomocą tie (stała)

Notka

Aż do C++17, funkcja nie może zwrócić krotki używając listy inicjalizacyjnej:

std::tuple<int, int> foo_tuple(){return{1, -1};// Blad az do C++17returnstd::make_tuple(1, -1);// Zawsze dziala}

Przykład

#include <tuple>#include <iostream>#include <string>#include <stdexcept>   std::tuple<double, char, std::string> get_student(int id){if(id ==0)returnstd::make_tuple(3.8, 'A', "Lisa Simpson");if(id ==1)returnstd::make_tuple(2.9, 'C', "Milhouse Van Houten");if(id ==2)returnstd::make_tuple(1.7, 'D', "Ralph Wiggum");throwstd::invalid_argument("id");}   int main(){auto student0 = get_student(0);std::cout<<"ID: 0, "<<"GPA: "<< std::get<0>(student0)<<", "<<"grade: "<< std::get<1>(student0)<<", "<<"name: "<< std::get<2>(student0)<<'\n';   double gpa1;char grade1;std::string name1;std::tie(gpa1, grade1, name1)= get_student(1);std::cout<<"ID: 1, "<<"GPA: "<< gpa1 <<", "<<"grade: "<< grade1 <<", "<<"name: "<< name1 <<'\n';}

Wynik:

ID: 0, GPA: 3.8, grade: A, name: Lisa Simpson ID: 1, GPA: 2.9, grade: C, name: Milhouse Van Houten