countr_zero.md

countr_zero

• bit[meta header]
• std[meta namespace]
• function template[meta id-type]
• cpp20[meta cpp]

namespace std {
  template <class T>
  constexpr int countr_zero(T x) noexcept;
}

概要

右から連続した0のビットを数える。

テンプレートパラメータ制約

• 型Tが符号なし整数型であること

戻り値

値xの、最下位ビット (LSB, least significant bit) から開始して連続した0ビットの数を返す。

x == 0の場合、符号なし整数型Tのビット数が返る。

例外

投げない

備考

• この関数は、ハードウェア機能として提供されている場合がある
• GCCの組み込み関数として__builtin_ctz()、__builtin_ctzl()、__builtin_ctzll()が定義されていた

例

#include <cassert>
#include <bit>
#include <cstdint>

int main()
{
  auto i = static_cast<std::uint32_t>(0b0000'0000'0000'0000'0000'0000'0000'1000u);
  int n = std::countr_zero(i);
  assert(n == 3);

  assert(std::countr_zero(static_cast<std::uint32_t>(0b0000'0000'0000'0000'0000'0000'0000'0001u)) == 0);
  assert(std::countr_zero(static_cast<std::uint32_t>(0b0000'0000'0000'0000'0000'0000'0000'0010u)) == 1);
  assert(std::countr_zero(static_cast<std::uint32_t>(0u)) == 32);
}

• std::countr_zero[color ff0000]
• std::uint32_t[link /reference/cstdint/uint32_t.md]

出力

バージョン

言語

• C++20

処理系

• Clang: 9.0
• GCC: 9.2
• Visual C++: ??

参照

• P0553R4 Bit operations