std::get (std::variant)

来自cppreference.com
< cpp‎ | utility‎ | variant
 
 
 
 
定义于头文件 <variant>
(1) (C++17 起)
template <std::size_t I, class... Types>

constexpr std::variant_alternative_t<
  I, std::variant<Types...>

>& get(std::variant<Types...>& v);
template <std::size_t I, class... Types>

constexpr std::variant_alternative_t<
  I, std::variant<Types...>

>&& get(std::variant<Types...>&& v);
template <std::size_t I, class... Types>

constexpr std::variant_alternative_t<
  I, std::variant<Types...>

> const& get(const std::variant<Types...>& v);
template <std::size_t I, class... Types>

constexpr std::variant_alternative_t<
  I, std::variant<Types...>

> const&& get(const std::variant<Types...>&& v);
(2) (C++17 起)
template <class T, class... Types>
constexpr T& get(std::variant<Types...>& v);
template <class T, class... Types>
constexpr T&& get(std::variant<Types...>&& v);
template <class T, class... Types>
constexpr const T& get(const std::variant<Types...>& v);
template <class T, class... Types>
constexpr const T&& get(const std::variant<Types...>&& v);
1) 基于下标的值访问器:若 v.index() == I ,则返回到存储于 v 的值的引用。否则抛出 std::bad_variant_access 。若 I 不是 varian 的合法下标,则此调用为病式。
2) 基于类型的值访问器:若 v 保有可选项 T ,则返回到存储于 v 的值的引用。否则抛出 std::bad_variant_access 。若 T 不是 Types... 中唯一存在的元素,则此调用为病式。

目录

[编辑] 参数

I - 要查找的下标
Type - 要查找的唯一类型
v - variant

[编辑] 返回值

到存储于 variant 中的值的引用。

[编辑] 异常

1,2) 错误时抛 std::bad_variant_access

[编辑] 示例

#include <variant>
#include <string>
 
int main()
{
    std::variant<int, float> v{12}, w;
    int i = std::get<int>(v);
    w = std::get<int>(v);
    w = std::get<0>(v); // 效果同前一行
 
//  std::get<double>(v); // 错误: [int, float] 中无 double
//  std::get<3>(v);      // 错误:合法的 index 值是 0 和 1
 
    try {
      std::get<float>(w); // w 含有 int ,非 float :将抛出异常
    }
    catch (std::bad_variant_access&) {}
}


[编辑] 参阅

(C++17)
给定下标或类型(若类型唯一),获得指向被指向的 variant 的值的指针,错误时返回空指针
(函数模板) [编辑]
tuple 访问指定的元素
(函数模板) [编辑]
访问 array 的一个元素
(函数模板) [编辑]
访问 pair 的一个元素
(函数模板) [编辑]