std::bitset<N>::to_string

 

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)

 

	(1)
template< class CharT, class Traits, class Allocator > std::basic_string<CharT, Traits, Allocator>     to_string( CharT zero = CharT('0'),                CharT one = CharT('1') ) const;			(bis C++11)
template<     class CharT = char,     class Traits = std::char_traits<CharT>,     class Allocator = std::allocator<CharT> > std::basic_string<CharT, Traits, Allocator>     to_string( CharT zero = CharT('0'),                CharT one = CharT('1') ) const;			(seit C++11) (constexpr seit C++23)
template< class CharT, class Traits > std::basic_string<CharT, Traits>     to_string( CharT zero = CharT('0'),                CharT one = CharT('1') ) const;		(2)	(bis C++11)
template< class CharT > std::basic_string<CharT> to_string( CharT zero = CharT('0'),                                     CharT one = CharT('1') ) const;		(3)	(bis C++11)
std::string to_string( char zero = '0', char one = '1' ) const;		(4)	(bis C++11)

Wandelt den Inhalt des Bitsets in einen String um. Verwendet zero zur Darstellung von Bits mit dem Wert false und one zur Darstellung von Bits mit dem Wert true.

Der resultierende String enthält N Zeichen, wobei das erste Zeichen dem letzten (N-1-ten) Bit und das letzte Zeichen dem ersten Bit entspricht.

Alle Template-Typargumente müssen angegeben werden, da Funktions-Templates keine standardmäßigen Template-Argumente haben können. Überladungen (2-4) werden bereitgestellt, um die Aufrufe von to_string zu vereinfachen. 2) Verwendet den Standard-Allocator std::allocator. 3) Verwendet die Standard-Zeichenbehandlung std::char_traits und den Standard-Allocator std::allocator. 4) Verwendet den Standard-Zeichentyp char, die Standard-Zeichenbehandlung std::char_traits und den Standard-Allocator std::allocator.

(bis C++11)

Parameter

null	-	Zeichen zur Darstellung von false
eins	-	Zeichen zur Darstellung von true

Rückgabewert

1) Der konvertierte String.

2) to_string<CharT, Traits, std::allocator<CharT>>(zero, one).

3) to_string<CharT, std::char_traits<CharT>, std::allocator<CharT>>(zero, one).

4) to_string<char, std::char_traits<char>, std::allocator<char>>(zero, one).

Ausnahmen

Kann std::bad_alloc vom Konstruktor von std::basic_string auslösen.

Hinweise

Seit C++11 können Funktions-Templates Standard-Template-Argumente haben. LWG-Issue 1113 entfernte die Hilfsüberladungen (2-4) und fügte die entsprechenden Standard-Template-Argumente in (1) hinzu.

Beispiel

Führen Sie diesen Code aus

#include <bitset>
#include <iostream>
 
int main()
{
    std::bitset<8> b{42};
    std::cout << b.to_string() << '\n'
              << b.to_string('*') << '\n'
              << b.to_string('O', 'X') << '\n';
}

Ausgabe

00101010
**1*1*1*
OOXOXOXO

Fehlerberichte

Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR	angewendet auf	Verhalten wie veröffentlicht	Korrigiertes Verhalten
LWG 396	C++98	Null- und Eins-Bits wurden in Zeichen konvertiert ​0​ und 1 (die nicht '0' und '1' entsprechen)	Parameter hinzugefügt, um Werte für diese Zeichen anzugeben
LWG 434	C++98	Alle Template-Argumente mussten angegeben werden	Überladungen (2-4) hinzugefügt
LWG 853	C++98	Überladungen (2-4) hatten nicht die Standard- Argumente, die durch LWG-Issue 396 hinzugefügt wurden	auch hinzugefügt

Siehe auch

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)