std::bit_floor

 

C++

编译器支持

独立式与宿主式

语言

标准库

标准库头文件

具名要求

特性测试宏 （C++20）

语言支持库

概念库 （C++20）

诊断库

内存管理库

元编程库 （C++11）

通用工具库

容器库

迭代器库

范围库 （C++20）

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 （C++17）

并发支持库 （C++11）

执行控制库 （C++26）

技术规范

符号索引

外部库

 

工具库

语言支持 类型支持 (基本类型，RTTI) 库特性测试宏 （C++20） 程序工具 可变参数函数 initializer_list （C++11） is_constant_evaluated （C++20） is_within_lifetime （C++26） source_location （C++20） 协程支持 （C++20） 契约支持 （C++26） 三向比较 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）

通用工具 函数对象 位操作 （C++20） bitset hash （C++11） 关系运算符 （C++20 中已弃用） rel_ops::operator!=rel_ops::operator>    rel_ops::operator<=rel_ops::operator>= 整数比较函数 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 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） 常用词汇类型 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）

 

位操作

bit_cast （C++20）

byteswap （C++23）

2 的整数次幂

has_single_bit （C++20）

bit_ceil （C++20）

bit_floor （C++20）

bit_width （C++20）

旋转

rotl （C++20）

rotr （C++20）

计数

countl_zero （C++20）

countl_one （C++20）

countr_zero （C++20）

countr_one （C++20）

popcount （C++20）

字节序

endian （C++20）

 

定义于头文件 <bit>
template< class T > constexpr T bit_floor( T x ) noexcept;		（C++20 起）

如果 x 不为零，则计算不大于 x 的最大 2 的整数次幂。 如果 x 为零，则返回零。

此重载仅在 T 是无符号整数类型时参与重载决议（即，unsigned char、unsigned short、unsigned int、unsigned long、unsigned long long 或扩展无符号整数类型）。

参数

x

-

无符号整数值

返回值

如果 x 为零则为零； 否则，为不大于 x 的最大 2 的整数次幂。

注解

在 P1956R1 之前，此函数模板的提议名称为 floor2。

特性测试 宏	值	Std	特性
__cpp_lib_int_pow2	202002L	（C++20）	2 的整数次幂运算

可能的实现

template<std::unsigned_integral T> requires !std::same_as<T, bool> && !std::same_as<T, char> && !std::same_as<T, char8_t> && !std::same_as<T, char16_t> && !std::same_as<T, char32_t> && !std::same_as<T, wchar_t> constexpr T bit_floor(T x) noexcept { if (x != 0) return T{1} << (std::bit_width(x) - 1); return 0; }

示例

运行此代码

#include <bit>
#include <bitset>
#include <iostream>
 
int main()
{
    using bin = std::bitset<8>;
    for (unsigned x{}; x != 012; ++x)
        std::cout << "bit_floor( " << bin(x) << " ) = "
                  << bin(std::bit_floor(x)) << '\n';
}

输出

bit_floor( 00000000 ) = 00000000
bit_floor( 00000001 ) = 00000001
bit_floor( 00000010 ) = 00000010
bit_floor( 00000011 ) = 00000010
bit_floor( 00000100 ) = 00000100
bit_floor( 00000101 ) = 00000100
bit_floor( 00000110 ) = 00000100
bit_floor( 00000111 ) = 00000100
bit_floor( 00001000 ) = 00001000
bit_floor( 00001001 ) = 00001000

参见

bit_ceil （C++20）	查找不小于给定值的最小 2 的整数次幂 （函数模板）
rotr （C++20）	计算按位右旋转的结果 （函数模板）
bit_width （C++20）	查找表示给定值所需的最小位数 （函数模板）
has_single_bit （C++20）	检查数字是否为 2 的整数次幂 （函数模板）