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

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

并发支持库 (C++11)

技术规范

符号索引

外部库

 

容器库

序列

array (C++11)

vector

vector<bool>

inplace_vector (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::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;

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。

成员函数

(构造函数)	构造引用，只有 std::vector<bool, Alloc> 自身可以访问 (公开成员函数)
(析构函数)	销毁引用 (公开成员函数)
operator=	将 bool 赋给被引用位 (公开成员函数)
operator bool	返回被引用位 (公开成员函数)
flip	翻转被引用位 (公开成员函数)

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

~reference();		(C++20 前)
constexpr ~reference();		(C++20 起)

销毁 reference。

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::vector<bool, Alloc>::reference 特化 std::formatter。此特化使用 std::formatter<bool, CharT> 作为它的底层格式化器（以 underlying_ 表示），所引用的位被转换为 bool 再格式化。

当且仅当 T 代表对于某个 Alloc 的类型 std::vector<bool, Alloc>::reference 且std::vector<bool, Alloc> 不是由程序定义的特化时，仅用于阐述的常量 /* is-vector-bool-reference */<T> 是 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 (公开静态成员函数)

外部链接

"Effective Modern C++" by Scott Meyers (2015), 第二章, 条款 6: "当 auto 推导为不想要的类型时使用类型明确的初始化式手法。" (p.43-46)——描述了代理类 std::vector<bool>::reference 的一种可能的误用。