std::get (std::variant)
定义于头文件 <variant>
|
||
(1) | (C++17 起) | |
template< std::size_t I, class... Types > constexpr std::variant_alternative_t<I, std::variant<Types...>>& |
||
template< std::size_t I, class... Types > constexpr std::variant_alternative_t<I, std::variant<Types...>>&& |
||
template< std::size_t I, class... Types > constexpr const std::variant_alternative_t<I, std::variant<Types...>>& |
||
template< std::size_t I, class... Types > constexpr const std::variant_alternative_t<I, std::variant<Types...>>& |
||
(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 | - | 要查找的下标 |
T | - | 要查找的唯一类型 |
Types... | - | 构成 variant 的类型
|
参数
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 的值的指针,错误时返回空指针 (函数模板) |
元组式访问指定的元素 (函数模板) | |
访问 array 的一个元素 (函数模板) | |
(C++11) |
访问 pair 的一个元素 (函数模板) |