std::variant<Types...>::index

C++ 参考手册

C++11
C++14
C++17
C++20
C++ 编译器支持情况表
独立与宿主实现
C++ 语言
C++ 关键词
预处理器
C++ 标准库头文件
具名要求
功能特性测试 (C++20)
工具库
程序支持工具
std::initializer_list
函数对象
std::hash
std::pair
std::tuple
std::optional
std::any
std::variant
std::hash <std::variant>
std::variant<Types...>::operator=
std::variant<Types...>::variant
std::variant<Types...>::~variant
std::variant<Types...>::index
std::variant<Types...>::valueless_by_exception
std::variant<Types...>::emplace
std::variant<Types...>::swap
std::visit
std::holds_alternative
std::get (std::variant)
std::get_if
operator==, !=, <, <=, >, >=, <=>(std::variant)
std::swap(std::variant)
std::monostate
std::bad_variant_access
std::variant_size, std::variant_size_v
std::variant_alternative, std::variant_alternative_t
std::variant_npos
std::apply
库特性测试宏 (C++20)
格式化库 (C++20)
std::integer_sequence
std::exchange
std::make_from_tuple
std::launder
std::to_chars
std::from_chars
std::as_const
std::source_location
变参数函数
std::bitset
std::cmp_equal, cmp_not_equal, cmp_less, cmp_greater, cmp_less_equal, cmp_greater_equal
std::in_range
std::declval
std::forward
std::move
std::move_if_noexcept
std::chars_format
std::piecewise_construct_t
std::piecewise_construct
std::in_place, std::in_place_type, std::in_place_index, std::in_place_t, std::in_place_type_t, std::in_place_index_t
注释
类型支持（基本类型、RTTI、类型特性）
概念库 (C++20)
错误处理
动态内存管理
日期和时间工具
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
输入/输出库
文件系统库
本地化库
正则表达式库
原子操作库
线程支持库
实验性 C++ 特性
有用的资源
索引
std 符号索引
协程支持 (C++20)
C++ 关键词

位置：首页 > C++ 参考手册 >工具库 >std::variant > std::variant<Types...>::index

constexpr std::size_t index() const noexcept;		(C++17 起)

返回 variant 当前所保有的可选项的零基下标。

若 variant 因异常无值（ valueless_by_exception ），则返回 variant_npos 。

示例

运行此代码

#include <variant>
#include <string>
#include <iostream>
int main()
{
    std::variant<int, std::string> v = "abc";
 
    std::cout << "v.index = " << v.index() << '\n';
 
    v = {}; 
 
    std::cout << "v.index = " << v.index() << '\n';
}

输出：

v.index = 1
v.index = 0

参阅

holds_alternative (C++17)	检查某个 `variant` 是否当前持有某个给定类型 (函数模板)
std::get(std::variant) (C++17)	以给定索引或类型（若类型唯一）读取 `variant` 的值，错误时抛出异常 (函数模板)