std::vector<bool, Alloc>::reference

 

C++

编译器支持

独立式和宿主式

语言

标准库

标准库头文件

具名要求

Feature test macros （C++20）

语言支持库

Concepts library （C++20）

诊断库

内存管理库

Metaprogramming library （C++11）

通用工具库

容器库

迭代器库

Ranges library （C++20）

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

Filesystem library （C++17）

Concurrency support library （C++11）

Execution control library （C++26）

技术规范

符号索引

外部库

 

容器库

序列

array （C++11）

vector

vector<bool>

inplace_vector （C++26）

hive （C++26）

deque

forward_list （C++11）

list

关联

set

multiset

map

multimap

无序关联

unordered_set （C++11）

unordered_multiset （C++11）

unordered_map （C++11）

unordered_multimap （C++11）

适配器

stack

queue

priority_queue

flat_set （C++23）

flat_multiset （C++23）

flat_map （C++23）

flat_multimap （C++23）

视图

span （C++20）

mdspan （C++23）

表格

迭代器失效

成员函数表

非成员函数表

 

std::vector<bool>

成员类型
vector<bool>::reference
成员函数
vector::vector vector::~vector vector::operator= vector::assign vector::assign_range （C++23） vector::get_allocator 元素访问 vector::operator[] vector::at vector::front vector::back 迭代器 vector::beginvector::cbegin （C++11） vector::endvector::cend （C++11） vector::rbeginvector::crbegin （C++11） vector::rendvector::crend （C++11）	容量 vector::empty vector::size vector::max_size vector::capacity vector::resize vector::reserve vector::shrink_to_fit （DR*） 修改器 vector::clear vector::erase vector::insert vector::insert_range （C++23） vector::append_range （C++23） vector::emplace （C++11） vector::emplace_back （C++11） vector::push_back vector::pop_back vector::swap vector<bool>::flip vector<bool>::swap
非成员函数
operator==operator<=> （C++20） swap（std::vector<bool>） erase（std::vector<bool>）erase_if（std::vector<bool>） （C++20）（C++20）	operator!=operator<operator>operator<=operator>= （C++20 前）（C++20 前）（C++20 前）（C++20 前）（C++20 前）
辅助类
hash<std::vector<bool>> （C++11）
Deduction guides （C++17）

 

class reference;

std::vector<bool, Alloc> 特化定义了 std::vector<bool, Alloc>::reference 为一个可公开访问的嵌套类。std::vector<bool, Alloc>::reference 代理了 std::vector<bool, Alloc> 中对单个比特的引用的行为。

std::vector<bool, Alloc>::reference 的主要用途是提供一个可以从 operator[] 返回的左值。

任何通过 std::vector<bool, Alloc>::reference 对 vector 的读取或写入都可能读取或写入整个底层 vector。

成员函数

（构造函数）	构造引用 （公共成员函数）
（析构函数）	销毁引用 （公共成员函数）
operator=	为引用的位赋值 （公共成员函数）
operator bool	返回引用的位 （公共成员函数）
flip	翻转引用的位 （公共成员函数）

std::vector<bool, Alloc>::reference::reference

reference( const reference& ) = default;		（自 C++11 起） （constexpr 自 C++20 起）

从另一个引用构造引用。 复制构造函数是隐式声明的。（C++11 前）

其他构造函数只能由 std::vector<bool, Alloc> 访问。

std::vector<bool, Alloc>::reference::~reference

~reference();		（constexpr 自 C++20 起）

销毁引用。

std::vector<bool, Alloc>::reference::operator=

reference& operator=( bool x );	(1)	（noexcept 自 C++11 起） （constexpr 自 C++20 起）
constexpr const reference& operator=( bool x ) const noexcept;	(2)	（自 C++23 起）
reference& operator=( const reference& x );	(3)	（noexcept 自 C++11 起） （constexpr 自 C++20 起）

为引用的位赋值。

参数

x

-

要赋值的值

返回值

*this

std::vector<bool, Alloc>::reference::operator bool

operator bool() const;		（noexcept 自 C++11 起） （constexpr 自 C++20 起）

返回引用的位的值。

返回值

引用的位。

std::vector<bool, Alloc>::reference::flip

void flip();		（noexcept 自 C++11 起） （constexpr 自 C++20 起）

反转引用的位。

辅助类

std::formatter<std::vector<bool, Alloc>::reference>

template< class T, class CharT >   requires /*is-vector-bool-reference*/<T> struct formatter<T, CharT>;		（自 C++23 起）

为 std::vector<bool, Alloc>::reference 特化 std::formatter。此特化使用 std::formatter<bool, CharT> 作为其底层格式器（记为 underlying_），其中引用的位被转换为 bool 以进行格式化。

仅用于演示的常量 /*is-vector-bool-reference*/<T> 当且仅当 T 表示类型 std::vector<bool, Alloc>::reference，对于某个类型 Alloc 且 std::vector<bool, Alloc> 不是程序定义的特化时为 true。

成员函数

template< class ParseContext > constexpr ParseContext::iterator parse( ParseContext& ctx );	(1)	（自 C++23 起）
template< class FormatContext > FormatContext::iterator format( const T& r, FormatContext& ctx ) const;	(2)	（自 C++23 起）

1) 等价于 return underlying_.parse(ctx);。

2) 等价于 return underlying_.format(r, ctx);。

参见

operator[]	访问指定的元素 （std::vector<T,Allocator> 的公共成员函数）
swap [静态]	交换两个 std::vector<bool>::reference （公共静态成员函数）

外部链接

Scott Meyers 的《Effective Modern C++》（2015 年），第 2 章，第 6 项：“当 auto 推导出不期望的类型时，使用显式类型初始化惯用法。”（第 43-46 页）— 描述了代理类 std::vector<bool>::reference 的一种可能的误用）。