Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::tuple — krotka elementów o ustalonych typach

std::tuple z nagłówka <tuple> grupuje ustaloną liczbę elementów, których typy mogą być różne. Dostęp zapewnia std::get, a wiązania strukturalne pozwalają nadać elementom lokalne nazwy.

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

Składnia

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

std::tuple<Types...> z nagłówka <tuple> przechowuje ustaloną liczbę elementów. Każdy argument szablonu określa typ jednej pozycji; typy mogą się powtarzać lub różnić. Liczba i typy pozycji są ustalone podczas kompilacji, ale wartości mogą być zmieniane, jeśli pozwalają na to ich typy i kwalifikatory.

std::get<I>(t) zwraca referencję do elementu o indeksie I, liczonym od zera. Indeks musi być stałą czasu kompilacji i mieścić się w zakresie; błędny indeks oznacza błąd kompilacji, nie wyjątek. std::get<T>(t) wybiera element według typu, ale wymaga, aby T występował dokładnie raz.

W przykładzie std::get<0>(item) zmienia pierwszy element z 3 na 5. Deklaracja auto& [count, label] = item; tworzy nazwy odnoszące się do elementów oryginalnej krotki. Natomiast auto [count, label] = item; w tym przykładzie utworzyłoby kopię krotki i powiązało nazwy z jej elementami.

Przykład jest przeznaczony do kompilacji z flagą -std=c++23. Wyświetlony kod uruchomiono bez zmian w odizolowanym środowisku i potwierdzono, że standardowe wyjście dokładnie zgadza się z podanym wynikiem. Ta weryfikacja nie potwierdza środowiska wykonawczego na produkcji. Źródło eel.is jest rozwijanym projektem standardu, a nie zamrożoną publikacją C++23; opis ogranicza się do funkcjonalności dostępnej w C++23.

Przykłady

#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';
}

Wynik

5 A

Wyświetlony kod uruchomiono bez zmian w odizolowanym środowisku. Standardowe wyjście dokładnie zgadzało się z podanym wynikiem.

Źródła