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

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Container-Bibliothek

Sequenz

array (C++11)

vector

vector<bool>

inplace_vector (C++26)

hive (C++26)

deque

forward_list (C++11)

list

Assoziativ

setzt

multiset

map

multimap

Ungeordnete assoziative

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

Adapter

stack

queue

priority_queue

flat_set (C++23)

flat_multiset (C++23)

flat_map (C++23)

flat_multimap (C++23)

Ansichten

span (C++20)

mdspan (C++23)

Tabellen

Iterator-Invalidierung

Mitgliedsfunktionstabelle

Nicht-Mitgliedsfunktionstabelle

 

std::vector<bool>

Membertypen
vector<bool>::reference
Memberfunktionen
vector::vector vector::~vector vector::operator= vector::assign vector::assign_range (C++23) vector::get_allocator Elementzugriff vector::operator[] vector::at vector::front vector::back Iteratoren vector::beginvector::cbegin (C++11) vector::endvector::cend (C++11) vector::rbeginvector::crbegin (C++11) vector::rendvector::crend (C++11)	Kapazität vector::empty vector::size vector::max_size vector::capacity vector::resize vector::reserve vector::shrink_to_fit (DR*) Modifizierer 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
Nicht-Member-Funktionen
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>= (bis C++20)(bis C++20)(bis C++20)(bis C++20)(bis C++20)
Hilfsklassen
hash<std::vector<bool>> (C++11)
Deduktionshilfen (C++17)

 

class reference;

Die Spezialisierungen von std::vector<bool, Alloc> definieren std::vector<bool, Alloc>::reference als eine öffentlich zugängliche, verschachtelte Klasse. std::vector<bool, Alloc>::reference proxysiert das Verhalten von Referenzen auf ein einzelnes Bit in std::vector<bool, Alloc>.

Der primäre Verwendungszweck von std::vector<bool, Alloc>::reference ist die Bereitstellung eines lvalues, der von operator[] zurückgegeben werden kann.

Jedes Lesen oder Schreiben in einen Vektor, das über eine std::vector<bool, Alloc>::reference erfolgt, kann potenziell den gesamten zugrunde liegenden Vektor lesen oder schreiben.

Memberfunktionen

(Konstruktor)	konstruiert die Referenz (öffentliche Memberfunktion)
(Destruktor)	zerstört die Referenz (öffentliche Memberfunktion)
operator=	weist dem referenzierten Bit einen Wert zu (öffentliche Memberfunktion)
operator bool	gibt das referenzierte Bit zurück (public member function)
wechselt	invertiert das referenzierte Bit (öffentliche Memberfunktion)

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

reference( const reference& ) = default;		(seit C++11) (constexpr seit C++20)

Konstruiert die Referenz aus einer anderen Referenz. Der Kopierkonstruktor wird implizit deklariert.(bis C++11)

Andere Konstruktoren sind nur durch std::vector<bool, Alloc> zugänglich.

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

~reference();		(constexpr seit C++20)

Zerstört die Referenz.

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

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

Weist dem referenzierten Bit einen Wert zu.

Parameter

x

-

zuweisender Wert

Rückgabewert

*this

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

operator bool() const;		(noexcept seit C++11) (constexpr seit C++20)

Gibt den Wert des referenzierten Bits zurück.

Rückgabewert

Das referenzierte Bit.

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

void flip();		(noexcept seit C++11) (constexpr seit C++20)

Invertiert das referenzierte Bit.

Hilfsklassen

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

template< class T, class CharT >   requires /*is-vector-bool-reference*/<T> struct formatter<T, CharT>;		(seit C++23)

Spezialisiert std::formatter für std::vector<bool, Alloc>::reference. Die Spezialisierung verwendet std::formatter<bool, CharT> als zugrunde liegenden Formatter (bezeichnet als underlying_), wobei das referenzierte Bit zur Formatierung in bool konvertiert wird.

Die expositions-nur-Konstante /*is-vector-bool-reference*/<T> ist true genau dann, wenn T den Typ std::vector<bool, Alloc>::reference für irgendeinen Typ Alloc bezeichnet und std::vector<bool, Alloc> keine benutzerdefinierte Spezialisierung ist.

Memberfunktionen

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

1) Äquivalent zu return underlying_.parse(ctx);.

2) Äquivalent zu return underlying_.format(r, ctx);.

Siehe auch

operator[]	Greift auf ein bestimmtes Element zu (öffentliche Memberfunktion von std::vector<T,Allocator>)
swap [static]	vertauscht zwei std::vector<bool>::references (public static member function)

Externe Links

"Effective Modern C++" von Scott Meyers (2015), Kapitel 2, Punkt 6: "Verwenden Sie das explizit typisierte Initialisierungsidiom, wenn auto unerwünschte Typen ableitet." (S. 43-46) — beschreibt eine mögliche Fehlverwendung der Proxy-Klasse std::vector<bool>::reference).