Namespaces
Variants

    std::bitset<N>::bitset

    来自 zh.cppreference.net
     
    C++
     
    工具库
    通用工具
    关系运算符 (C++20 中弃用)
    整数比较函数
    (C++20)(C++20)(C++20)    
    (C++20)
    交换 与 类型操作
    (C++20)
    (C++14)
    (C++11)
    (C++23)
    (C++11)
    (C++23)
    (C++11)
    (C++11)
    (C++17)
    常用词汇类型
    (C++11)
    (C++17)
    (C++17)
    (C++17)
    (C++11)
    (C++11)
    (C++17)
    (C++17)
    (C++23)



     
    std::bitset
     
    bitset();
    		(1) (C++11 起为 noexcept)
    (C++11 起为 constexpr)    		 
    bitset( unsigned long val );
    		(2) (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)

    从以下多个可选数据源之一构造新的 bitset：

    1) 默认构造函数。构造所有位都设为 0 的 bitset。
    2) 从无符号整数 val 构造 bitset。
    给定 值表示中的位数unsigned long(C++11 前)unsigned long long(C++11 起) 作为 S：
    • 前（最右端、最低有效）std::min(S, N) 个位位置被初始化为 val 的对应位值。
    • 如果 S 小于 N，剩余的位位置被初始化为 0。
    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
    (公开成员函数)