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

 

C++

编译器支持

独立和宿主

语言

标准库

标准库头文件

命名需求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用实用程序库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

执行支持库 (C++26)

技术规范

符号索引

外部库

 

容器库

序列

数组 (C++11)

向量

vector<bool>

inplace_vector (C++26)

双端队列

单向链表 (C++11)

链表

关联式

集合

多重集合

映射

多重映射

无序关联式

无序集合 (C++11)

无序多重集合 (C++11)

无序映射 (C++11)

无序多重映射 (C++11)

适配器

栈

队列

优先级队列

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::vector vector::~vector vector::operator=	vector::assign vector::get_allocator
元素访问
vector::at vector::operator[]	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::reserve vector::capacity
修饰符
vector::clear vector::insert vector::emplace (C++11)   vector::erase vector::push_back	vector::emplace_back (C++11) vector::pop_back vector::resize vector::swap
std::vector<bool> 特定
vector<bool>::flip
vector<bool>::swap
非成员函数
operator==operator!=operator<operator>operator<=operator>=operator<=> (直到 C++20)(直到 C++20)(直到 C++20)(直到 C++20)(直到 C++20)(C++20)	swap(std::vector<bool>) erase(std::vector<bool>)erase_if(std::vector<bool>) (C++20)(C++20)
辅助类
hash<std::vector<bool>> (C++11)
推导指南(C++17)

 

class reference;

The std::vector<bool, Alloc> specializations define std::vector<bool, Alloc>::reference as a publicly-accessible nested class. std::vector<bool, Alloc>::reference proxies the behavior of references to a single bit in std::vector<bool, Alloc>.

The primary use of std::vector<bool, Alloc>::reference is to provide an lvalue that can be returned from operator[].

Any reads or writes to a vector that happen via a std::vector<bool, Alloc>::reference potentially read or write to the entire underlying vector.

成员函数

(构造函数)	构造引用。仅对 std::vector<bool, Alloc> 本身可见 (公共成员函数)
(析构函数)	销毁引用 (公共成员函数)
operator=	将一个 bool 赋值给引用的位 (公共成员函数)
operator bool	返回引用的位 (公共成员函数)
flip	翻转引用的位 (公共成员函数)

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

~reference();		(直到 C++20)
constexpr ~reference();		(自 C++20 起)

销毁引用。

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

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

将一个值赋值给引用的位。

参数

x

-

要赋值的值

返回值

*this

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

operator bool() const;		(直到 C++11)
operator bool() const noexcept;		(自 C++11 起) (直到 C++20)
constexpr operator bool() const noexcept;		(自 C++20 起)

返回引用的位的值。

参数

(无)

返回值

引用的位。

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

void flip();		(直到 C++11)
void flip() noexcept;		(自 C++11 起) (直到 C++20)
constexpr void flip() noexcept;		(自 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::formatter， 用于 std::vector<bool, Alloc>::reference。该专门化使用 std::formatter<bool, CharT> 作为其底层格式化器（表示为 underlying_），其中引用的位被转换为 bool 以便进行格式化。

仅供说明的常量 /* is-vector-bool-reference */<T> 当且仅当 T 表示类型 std::vector<bool, Alloc>::reference 时为 true， 其中 Alloc 为某种类型， 并且 std::vector<bool, Alloc> 不是 用户定义的专门化。

成员函数

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 [static]	交换两个 std::vector<bool>::references (公有静态成员函数)

外部链接

Scott Meyers 编著的“Effective Modern C++”（2015 年），第 2 章，第 6 条：“当 auto 推断出不想要的类型时，使用显式类型初始化习惯用法。”（第 43-46 页）—— 描述了可能误用代理类 std::vector<bool>::reference 的情况。