Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::tie — krotka referencji do istniejących obiektów

std::tie z nagłówka <tuple> tworzy krotkę referencji lvalue do istniejących obiektów. Pozwala przypisywać elementy krotki do zmiennych oraz pomijać wybrane pozycje za pomocą std::ignore, bez tworzenia kopii wskazanych obiektów.

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

Składnia

#include <tuple>

template<class... TTypes>
constexpr std::tuple<TTypes&...> std::tie(TTypes&... t) noexcept;

std::tie(t...) zwraca std::tuple<TTypes&...>: nową krotkę zawierającą referencje lvalue do argumentów, a nie kopie ich wartości. Funkcja jest zadeklarowana jako constexpr i noexcept; wymaga nagłówka <tuple>. Samo utworzenie krotki referencji nie zmienia argumentów.

Przypisanie do takiej krotki zapisuje wartości w obiektach, do których odnoszą się jej elementy; nie zmienia powiązania referencji. Zapis std::tie(count, std::ignore, score) = std::make_tuple(3, 99, 7) ustawia count i score, pomijając środkowy element. Liczba elementów musi pasować, a każde niepomijane przypisanie musi być poprawne dla odpowiednich typów. noexcept funkcji std::tie nie oznacza, że późniejsze przypisania nie mogą zgłaszać wyjątków.

Przy dedukcji argumentów szablonu wywołanie std::tie(42) jest niepoprawne: wydedukowany parametr int& nie może związać się z obiektem tymczasowym. Wywołanie std::tie<const int>(42) jest jednak poprawne, ponieważ parametr const int& może związać się z obiektem tymczasowym. Zwrócona krotka nie przedłuża życia tego obiektu poza koniec pełnego wyrażenia zawierającego wywołanie. Można związać obiekt const, lecz otrzymana referencja nie pozwala go modyfikować. Krotka nie posiada wskazanych obiektów i nie przedłuża ich życia; nie używaj referencji po zniszczeniu tych obiektów.

W odróżnieniu od std::tie, std::make_tuple dla zwykłych argumentów tworzy elementy przechowujące wartości. W przykładzie auto refs = std::tie(count, score) nadal przechowuje referencje mimo użycia auto. Po rozpakowaniu wartości zapis przez std::get<0>(refs) ponownie zmienia count, dlatego oczekiwany wynik to 5 7.

Przykłady

#include <iostream>
#include <tuple>

int main() {
    int count = 0;
    int score = 0;
    auto refs = std::tie(count, score);

    std::tie(count, std::ignore, score) = std::make_tuple(3, 99, 7);
    std::get<0>(refs) = 5;

    std::cout << count << ' ' << score << '\n';
}

Wynik

5 7

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła