Namespaces
Variants

std::bitset<N>:: bitset

From cppreference.net
C++
Utilities library
std::bitset
bitset ( ) ;
(1) (自 C++11 起为 noexcept)
(自 C++11 起为 constexpr)
(2)
bitset ( unsigned long val ) ;
(C++11 前)
constexpr bitset ( unsigned long long val ) noexcept ;
(自 C++11 起)
template < class CharT, class Traits, class Alloc >

explicit bitset
( const std:: basic_string < CharT, Traits, Alloc > & str,
typename std:: basic_string
< CharT, Traits, Alloc > :: size_type pos = 0 ,
typename std:: basic_string < CharT, Traits, Alloc > :: size_type
n = std:: basic_string < CharT, Traits, Alloc > :: npos ,

CharT zero = CharT ( '0' ) , CharT one = CharT ( '1' ) ) ;
(3) (自 C++23 起为 constexpr)
template < class CharT, class Traits >

constexpr explicit bitset
( std:: basic_string_view < CharT, Traits > str,
std:: size_t pos = 0 , std:: size_t n = std:: size_t ( - 1 ) ,

CharT zero = CharT ( '0' ) , CharT one = CharT ( '1' ) ) ;
(4) (自 C++26 起)
template < class CharT >

explicit bitset ( const CharT * str, std:: size_t n = std:: size_t ( - 1 ) ,

CharT zero = CharT ( '0' ) , CharT one = CharT ( '1' ) ) ;
(5) (自 C++11 起)
(自 C++23 起为 constexpr)

从若干可选数据源之一构造新的位集：

1) 默认构造函数。构造一个所有位都设置为零的位集。
2) 从无符号整数 val 构造一个 bitset。
给定 unsigned long (C++11 前) unsigned long long (C++11 起) 的 值表示 的位数为 S ：
  • 前（最右侧、最低有效） std:: min ( S, N ) 个位位置使用 val 的对应位值进行初始化。
  • 若 S 小于 N ，则剩余的位位置初始化为零。
3) 使用字符串 str 中的字符构造一个 bitset。可提供起始位置 pos 和长度 n 参数，以及用于表示置位（ one ）和清零（ zero ）位的替代字符。使用 Traits::eq() 来比较字符值。
初始化字符串的有效长度为 std:: min ( n, str. size ( ) - pos ) 。
4) 与 (3) 类似，但使用 std::basic_string_view 而非 std::basic_string 。
5) 与 (3) 类似，但使用 const CharT * 而非 std::basic_string 。

等价于 bitset ( n == std:: basic_string < CharT > :: npos
? std:: basic_string < CharT > ( str )
: std:: basic_string < CharT > ( str, n ) , 0 , n, zero, one ) 。

(C++26 前)

等价于 bitset ( n == std:: basic_string_view < CharT > :: npos
? std:: basic_string_view < CharT > ( str )
: std:: basic_string_view < CharT > ( str, n ) , 0 , n, zero, one ) 。

(C++26 起)

目录

参数

val - 用于初始化位集的数值
str - 用于初始化位集的字符串
pos - 在 str 中的起始偏移量
n - 从 str 中使用的字符数量
zero - str 中未设置位的替代字符
one - str 中设置位的替代字符

异常

3,4) std::out_of_range 若 pos > str. size ( ) ， std::invalid_argument 若存在字符不是 one 或 zero 。
5) std::invalid_argument 如果存在任何字符不是 one 或 zero 。

注释

功能测试 宏 值 标准 功能
__cpp_lib_constexpr_bitset 202207L (C++23) 更常量表达式化的 std::bitset ，重载版本 ( 3,5 )
__cpp_lib_bitset 202306L (C++26) std::bitset 与 std::string_view 的交互， ( 4 )

示例

运行此代码 
#include <bitset>
#include <climits>
#include <iostream>
#include <string>
int main()
{
    // 空构造函数 (1)
    std::bitset<8> b1; // [0,0,0,0,0,0,0,0]
    // 无符号长整型构造函数 (2)
    std::bitset<8> b2(42);          // [0,0,1,0,1,0,1,0]
    std::bitset<70> bl(ULLONG_MAX); // [0,0,0,0,0,0,1,1,1,...,1,1,1] in C++11
    std::bitset<8> bs(0xfff0);      // [1,1,1,1,0,0,0,0]
    // 字符串构造函数 (3)
    std::string bit_string = "110010";
    std::bitset<8> b3(bit_string);       // [0,0,1,1,0,0,1,0]
    std::bitset<8> b4(bit_string, 2);    // [0,0,0,0,0,0,1,0]
    std::bitset<8> b5(bit_string, 2, 3); // [0,0,0,0,0,0,0,1]
    // 使用自定义零/一数字的字符串构造函数 (3)
    std::string alpha_bit_string = "aBaaBBaB";
    std::bitset<8> b6(alpha_bit_string, 0, alpha_bit_string.size(),
                      'a', 'B');         // [0,1,0,0,1,1,0,1]
    // 使用自定义数字的字符指针构造函数 (5)
    std::bitset<8> b7("XXXXYYYY", 8, 'X', 'Y'); // [0,0,0,0,1,1,1,1]
    std::cout <<   "b1: " << b1 << "\nb2: " << b2 << "\nbl: " << bl
              << "\nbs: " << bs << "\nb3: " << b3 << "\nb4: " << b4
              << "\nb5: " << b5 << "\nb6: " << b6 << "\nb7: " << b7 << '\n';
}

可能的输出： 

b1: 00000000
b2: 00101010
bl: 0000001111111111111111111111111111111111111111111111111111111111111111
bs: 11110000
b3: 00110010
b4: 00000010
b5: 00000001
b6: 01001101
b7: 00001111

缺陷报告

下列行为变更缺陷报告被追溯应用于先前发布的 C++ 标准。

缺陷报告 适用标准 发布行为 正确行为
LWG 396 C++98 重载 (3) 的零和一字符值
为 ​ 0 ​ 和 1 （与 '0' 和 '1' 不符） 		添加参数以提供
这些字符的值
LWG 457 C++98 重载 (2) 的 S 为 CHAR_BIT * sizeof ( unsigned long )
但 unsigned long 不能
保证使用所有位表示其值 		改为考虑值的
二进制表示位数
LWG 2250 C++98 当 pos > str. size ( ) 为 true 时行为未定义 此情况下始终
抛出异常

参见

将位设置为 true 或给定值
(公开成员函数)
将位设置为 false
(公开成员函数)