std::bitset

 

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

 

Dienstprogramm-Bibliotheken

Sprachunterstützung Typunterstützung (Basistypen, RTTI) Bibliotheks-Feature-Test-Makros (C++20) Programm-Dienstprogramme Variadische Funktionen initializer_list (C++11) is_constant_evaluated (C++20) is_within_lifetime (C++26) source_location (C++20) Coroutine-Unterstützung (C++20) Vertragsunterstützung (C++26) Drei-Wege-Vergleich three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20)   is_eqis_ltis_lteq (C++20)(C++20)(C++20)   is_neqis_gtis_gteq (C++20)(C++20)(C++20)

Allgemeine Hilfsmittel Funktionsobjekte Bit-Manipulation (C++20) bitset hash (C++11) Relationale Operatoren (in C++20 veraltet) rel_ops::operator!=rel_ops::operator>    rel_ops::operator<=rel_ops::operator>= Ganzzahl-Vergleichsfunktionen cmp_equalcmp_lesscmp_less_than (C++20)(C++20)(C++20)   cmp_not_equalcmp_greatercmp_greater_than (C++20)(C++20)(C++20) in_range (C++20) Swap und Typ-Operationen swap ranges::swap (C++20) exchange (C++14) declval (C++11) to_underlying (C++23) forward (C++11) forward_like (C++23) move (C++11) move_if_noexcept (C++11) as_const (C++17) Gemeinsame Vokabulartypen pair tuple (C++11) optional (C++17) any (C++17) variant (C++17) tuple_size (C++11) tuple_element (C++11) apply (C++17) make_from_tuple (C++17) expected (C++23)

 

std::bitset

Membertypen
bitset::reference
Memberfunktionen
bitset::bitset
bitset::operator==bitset::operator!= (bis C++20)
Elementzugriff
bitset::operator[]
bitset::test
bitset::allbitset::anybitset::none (C++11)
bitset::count
Kapazität
bitset::size
Modifizierer
bitset::operator&=bitset::operator|=bitset::operator^=bitset::operator~
bitset::operator<<=bitset::operator>>=bitset::operator<<bitset::operator>>
bitset::set
bitset::reset
bitset::flip
Konvertierungen
bitset::to_string
bitset::to_ulong
bitset::to_ullong (C++11)
Nicht-Member-Funktionen
operator&operator|operator^	operator<<operator>>
Hilfsklassen
std::hash (C++11)

 

Definiert in der Header-Datei <bitset>
template< std::size_t N > class bitset;

Die Klassenschablone bitset repräsentiert eine feste Sequenz von N Bits. Bitsets können mit Standard-Logikoperatoren manipuliert und in und aus Zeichenketten und ganzen Zahlen konvertiert werden. Für die Zwecke der Zeichenkettenrepräsentation und der Benennung von Richtungen für Schiebeoperationen wird die Sequenz so betrachtet, als ob ihre Elemente mit dem niedrigsten Index sich rechts befinden, wie in der Binärdarstellung von ganzen Zahlen.

bitset erfüllt die Anforderungen an CopyConstructible und CopyAssignable.

Alle Memberfunktionen von std::bitset sind constexpr: Es ist möglich, std::bitset-Objekte während der Auswertung eines konstanten Ausdrucks zu erstellen und zu verwenden.

(seit C++23)

Template-Parameter

N

-

die Anzahl der Bits, für die Speicherplatz zugewiesen werden soll

Membertypen

Referenz

Proxy-Klasse, die eine Referenz auf ein Bit repräsentiert (Klasse)

Memberfunktionen

(Konstruktor)	konstruiert das Bitset (public member function)
operator==operator!= (in C++20 entfernt)	vergleicht den Inhalt (public member function)
Elementzugriff
operator[]	greift auf ein bestimmtes Bit zu (public member function)
testet	greift auf ein bestimmtes Bit zu (public member function)
allanynone	prüft, ob alle, einige oder keine der Bits auf true gesetzt sind (public member function)
zählt	gibt die Anzahl der auf true gesetzten Bits zurück (public member function)
Kapazität
size	gibt die Anzahl der Bits zurück, die das Bitset enthält (public member function)
Modifizierer
operator&=operator|=operator^=operator~	führt binäre AND-, OR-, XOR- und NOT-Operationen durch (public member function)
operator<<=operator>>=operator<<operator>>	führt binäre Links- und Rechtsschiebeoperationen durch (public member function)
setzt	setzt Bits auf true oder auf einen gegebenen Wert (public member function)
reset	setzt Bits auf false (public member function)
wechselt	vertauscht die Werte von Bits (public member function)
Konvertierungen
to_string	gibt eine Zeichenkettenrepräsentation der Daten zurück (public member function)
to_ulong	gibt eine unsigned long-Ganzzahlrepräsentation der Daten zurück (public member function)
to_ullong (C++11)	gibt eine unsigned long long-Ganzzahlrepräsentation der Daten zurück (public member function)

Nicht-Memberfunktionen

operator&operator|operator^	führt binäre Logikoperationen auf Bitsets durch (function template)
operator<<operator>>	führt Stream-Ein- und -Ausgabe von Bitsets durch (function template)

Hilfsklassen

std::hash<std::bitset> (C++11)

Hash-Unterstützung für std::bitset (Klassentemplate-Spezialisierung)

Hinweise

Wenn die Größe eines Bit-Sets zur Kompilierzeit nicht bekannt ist oder seine Größe zur Laufzeit geändert werden muss, können dynamische Typen wie std::vector<bool> oder boost::dynamic_bitset<> stattdessen verwendet werden.

Feature-Test-Makro	Wert	Std	Feature
__cpp_lib_constexpr_bitset	202207L	(C++23)	Ein constexpr-fähigeres std::bitset
__cpp_lib_bitset	202306L	(C++26)	Schnittstellen von std::bitset mit std::string_view

Beispiel

Führen Sie diesen Code aus

#include <bitset>
#include <cassert>
#include <cstddef>
#include <iostream>
 
int main()
{
    typedef std::size_t length_t, position_t; // the hints
 
    // constructors:
    constexpr std::bitset<4> b1;
    constexpr std::bitset<4> b2{0xA}; // == 0B1010
    std::bitset<4> b3{"0011"}; // can also be constexpr since C++23
    std::bitset<8> b4{"ABBA", length_t(4), /*0:*/'A', /*1:*/'B'}; // == 0B0000'0110
 
    // bitsets can be printed out to a stream:
    std::cout << "b1:" << b1 << "; b2:" << b2 << "; b3:" << b3 << "; b4:" << b4 << '\n';
 
    // bitset supports bitwise operations:
    b3 |= 0b0100; assert(b3 == 0b0111);
    b3 &= 0b0011; assert(b3 == 0b0011);
    b3 ^= std::bitset<4>{0b1100}; assert(b3 == 0b1111);
 
    // operations on the whole set:
    b3.reset(); assert(b3 == 0);
    b3.set(); assert(b3 == 0b1111);
    assert(b3.all() && b3.any() && !b3.none());
    b3.flip(); assert(b3 == 0);
 
    // operations on individual bits:
    b3.set(position_t(1), true); assert(b3 == 0b0010);
    b3.set(position_t(1), false); assert(b3 == 0);
    b3.flip(position_t(2)); assert(b3 == 0b0100);
    b3.reset(position_t(2)); assert(b3 == 0);
 
    // subscript operator[] is supported:
    b3[2] = true; assert(true == b3[2]);
 
    // other operations:
    assert(b3.count() == 1);
    assert(b3.size() == 4);
    assert(b3.to_ullong() == 0b0100ULL);
    assert(b3.to_string() == "0100");
}

Ausgabe

b1:0000; b2:1010; b3:0011; b4:00000110

Siehe auch

vector<bool>	speichereffizientes dynamisches Bitset (class template specialization)
Bitmanipulation (C++20)	Dienstprogramme zum Zugriff, zur Manipulation und zur Verarbeitung einzelner Bits und Bitsequenzen