std::get_if (std::variant)

来自cppreference.com
< cpp‎ | utility‎ | variant
 
C++
 
工具库
通用工具
关系运算符 (C++20 弃用)
 
std::variant
 
在标头 <variant> 定义
(1) (C++17 起)
template< std::size_t I, class... Types >

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

    get_if( std::variant<Types...>* pv ) noexcept;
template< std::size_t I, class... Types >

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

    get_if( const std::variant<Types...>* pv ) noexcept;
(2) (C++17 起)
template< class T, class... Types >

constexpr std::add_pointer_t<T>

    get_if( std::variant<Types...>* pv ) noexcept;
template< class T, class... Types >

constexpr std::add_pointer_t<const T>

    get_if( const std::variant<Types...>* pv ) noexcept;
1) 基于索引的不抛出访问器：若 pv 不是空指针且 pv->index() == I，则返回指向 pv 所指向的变体中存储的值的指针。否则，返回空指针值。若 I 不是此变体的有效索引，则此调用非良构。
2) 基于类型的不抛出访问器：等价于 (1)，其中 I 是 T 在 Types... 中的零基索引。若 T 不是 Types... 中的独有元素，则此调用非良构。

目录

[编辑] 模板形参

I - 要查找的索引
Type - 要查找的独有类型

[编辑] 参数

pv - 指向变体的指针

[编辑] 返回值

指向被指向的变体中存储值的指针，错误时为空指针。

[编辑] 示例

运行此代码
#include <iostream>
#include <variant>
 
int main()
{
    auto check_value = [](const std::variant<int, float>& v)
    {
        if (const int* pval = std::get_if<int>(&v))
            std::cout << "变体值: " << *pval << '\n';
        else
            std::cout << "获取值失败！" << '\n';
    };
 
    std::variant<int, float> v{12}, w{3.f};
    check_value(v);
    check_value(w);
}

输出： 

变体值: 12
获取值失败！

[编辑] 参阅

(C++17)
 以给定索引或类型（如果类型唯一）读取 variant 的值，错误时抛出异常
(函数模板) [编辑]
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/utility/variant/get_if&oldid=92095”