Difference between revisions of "cpp/numeric/countr zero"
From cppreference.com
m (→Notes: ~FTM) |
m (fmt) |
||
| (One intermediate revision by one user not shown) | |||
| Line 1: | Line 1: | ||
{{cpp/title|countr_zero}} | {{cpp/title|countr_zero}} | ||
{{cpp/numeric/navbar}} | {{cpp/numeric/navbar}} | ||
| − | {{ddcl | header=bit | since=c++20 | | + | {{ddcl|header=bit|since=c++20| |
template< class T > | template< class T > | ||
constexpr int countr_zero( T x ) noexcept; | constexpr int countr_zero( T x ) noexcept; | ||
}} | }} | ||
| − | Returns the number of consecutive 0 bits in the value of {{ | + | Returns the number of consecutive {{c|0}} bits in the value of {{c|x}}, starting from the least significant bit ("right"). |
| − | {{cpp/enable_if|{{tt|T}} is an unsigned integer type (that is, {{c|unsigned char}}, {{c|unsigned short}}, {{c|unsigned int}}, {{c|unsigned long}}, {{c|unsigned long long}}, or an extended unsigned integer type)}}. | + | {{cpp/enable_if|{{tt|T}} is an unsigned integer type (that is, {{c/core|unsigned char}}, {{c/core|unsigned short}}, {{c/core|unsigned int}}, {{c/core|unsigned long}}, {{c/core|unsigned long long}}, or an extended unsigned integer type)}}. |
===Parameters=== | ===Parameters=== | ||
{{par begin}} | {{par begin}} | ||
| − | {{par | x | value of unsigned integer type}} | + | {{par|x|value of unsigned integer type}} |
{{par end}} | {{par end}} | ||
===Return value=== | ===Return value=== | ||
| − | The number of consecutive 0 bits in the value of {{ | + | The number of consecutive {{c|0}} bits in the value of {{c|x}}, starting from the least significant bit. |
===Notes=== | ===Notes=== | ||
{{feature test macro|__cpp_lib_bitops|std=C++20|value=201907L|[[cpp/numeric#Bit_manipulation (since C++20)|Bit operations]]}} | {{feature test macro|__cpp_lib_bitops|std=C++20|value=201907L|[[cpp/numeric#Bit_manipulation (since C++20)|Bit operations]]}} | ||
| − | === Example === | + | ===Example=== |
{{example | {{example | ||
|code= | |code= | ||
| Line 31: | Line 31: | ||
int main() | int main() | ||
{ | { | ||
| − | for (const std::uint8_t i : { 0, 0b11111111, 0b00011100, 0b00011101 }) | + | for (const std::uint8_t i : {0, 0b11111111, 0b00011100, 0b00011101}) |
std::cout << "countr_zero( " << std::bitset<8>(i) << " ) = " | std::cout << "countr_zero( " << std::bitset<8>(i) << " ) = " | ||
<< std::countr_zero(i) << '\n'; | << std::countr_zero(i) << '\n'; | ||
| − | |||
} | } | ||
|output= | |output= | ||
| Line 43: | Line 42: | ||
}} | }} | ||
| − | === See also === | + | ===See also=== |
{{dsc begin}} | {{dsc begin}} | ||
| − | {{dsc inc | cpp/numeric/dsc countl_zero}} | + | {{dsc inc|cpp/numeric/dsc countl_zero}} |
| − | {{dsc inc | cpp/numeric/dsc countl_one}} | + | {{dsc inc|cpp/numeric/dsc countl_one}} |
| − | {{dsc inc | cpp/numeric/dsc countr_one}} | + | {{dsc inc|cpp/numeric/dsc countr_one}} |
| − | {{dsc inc | cpp/numeric/dsc popcount}} | + | {{dsc inc|cpp/numeric/dsc popcount}} |
| − | {{dsc inc | cpp/utility/bitset/dsc | + | {{dsc inc|cpp/utility/bitset/dsc all any none}} |
{{dsc end}} | {{dsc end}} | ||
{{langlinks|es|ja|ru|zh}} | {{langlinks|es|ja|ru|zh}} | ||
Latest revision as of 14:12, 2 November 2024
| Defined in header <bit>
|
||
| template< class T > constexpr int countr_zero( T x ) noexcept; |
(since C++20) | |
Returns the number of consecutive 0 bits in the value of x, starting from the least significant bit ("right").
This overload participates in overload resolution only if T is an unsigned integer type (that is, unsigned char, unsigned short, unsigned int, unsigned long, unsigned long long, or an extended unsigned integer type).
Contents |
[edit] Parameters
| x | - | value of unsigned integer type |
[edit] Return value
The number of consecutive 0 bits in the value of x, starting from the least significant bit.
[edit] Notes
| Feature-test macro | Value | Std | Feature |
|---|---|---|---|
__cpp_lib_bitops |
201907L | (C++20) | Bit operations |
[edit] Example
Run this code
#include <bit> #include <bitset> #include <cstdint> #include <iostream> int main() { for (const std::uint8_t i : {0, 0b11111111, 0b00011100, 0b00011101}) std::cout << "countr_zero( " << std::bitset<8>(i) << " ) = " << std::countr_zero(i) << '\n'; }
Output:
countr_zero( 00000000 ) = 8 countr_zero( 11111111 ) = 0 countr_zero( 00011100 ) = 2 countr_zero( 00011101 ) = 0
[edit] See also
| (C++20) |
counts the number of consecutive 0 bits, starting from the most significant bit (function template) |
| (C++20) |
counts the number of consecutive 1 bits, starting from the most significant bit (function template) |
| (C++20) |
counts the number of consecutive 1 bits, starting from the least significant bit (function template) |
| (C++20) |
counts the number of 1 bits in an unsigned integer (function template) |
| checks if all, any or none of the bits are set to true (public member function of std::bitset<N>)
|
