База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::get: достъп до елемент на tuple-like или variant

std::get избира елемент чрез константен индекс или еднозначен тип и връща референция със запазени категория на стойността и const.

Версия: C++23

Синтаксис

template<std::size_t I, class... Types>
constexpr decltype(auto) std::get(std::tuple<Types...>& t); // cv/ref overloads

template<class T, class... Types>
constexpr decltype(auto) std::get(std::tuple<Types...>& t); // cv/ref overloads

// Corresponding overload families exist for std::pair, std::array, and std::variant.

std::get<I> има групи претоварвания за std::tuple, std::pair, std::array и std::variant; std::get<T> важи за tuple, pair и variant, когато T се среща точно веднъж. Нулево базираният индекс е константа при компилация. Резултатът е референция: lvalue дава T& или const T&, а rvalue — съответната rvalue референция.

Примерът взема индекс 0 и тип std::string от tuple, после std::string от активната алтернатива на variant, затова извежда 7 blue ready. Присвояване през референцията на неконстантен tuple би променило съхранения елемент; копие не се създава.

Индекс извън диапазона или тип, който не се среща точно веднъж, е грешка при компилация. При std::variant иначе валидно get<I>/get<T> хвърля std::bad_variant_access, ако е активна друга алтернатива. За нормално несъвпадение използвай std::get_if или std::holds_alternative. Референцията не бива да надживее изходния обект.

Примери

#include <iostream>
#include <string>
#include <tuple>
#include <variant>

int main() {
    std::tuple<int, std::string> row{7, "blue"};
    std::variant<int, std::string> state = std::string{"ready"};

    std::cout << std::get<0>(row) << ' '
              << std::get<std::string>(row) << ' '
              << std::get<std::string>(state) << '\n';
}

Резултат

7 blue ready

std::get → 7 blue ready

Източници