4. stdc_bit_width

最終更新日時(UTC):
が更新

履歴 編集

function template
<stdbit.h>

stdc_bit_width(C++26)

template<class T>
unsigned int stdc_bit_width(T value);

unsigned int stdc_bit_width_uc(unsigned char value);
unsigned int stdc_bit_width_us(unsigned short value);
unsigned int stdc_bit_width_ui(unsigned int value);
unsigned int stdc_bit_width_ul(unsigned long value);
unsigned int stdc_bit_width_ull(unsigned long long value);

概要

値を表現するために必要なビット幅を求める。

C言語の<stdbit.h>で定義される関数であり、C++においてはC互換性のために提供される。C言語では汎用版は型総称マクロ (type-generic macro) として定義されるが、C++では関数テンプレートとして提供される。

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

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

戻り値

valueが0なら0、そうでなければfloor(log2(value)) + 1を返す。

例

#include <stdbit.h>
#include <cassert>
#include <cstdint>

int main() {
  assert(stdc_bit_width(static_cast<std::uint8_t>(0b0000'1000)) == 4);
  assert(stdc_bit_width(static_cast<std::uint8_t>(0)) == 0);
  assert(stdc_bit_width(static_cast<std::uint8_t>(0b0000'0001)) == 1);

  // 型別関数
  assert(stdc_bit_width_uc(static_cast<unsigned char>(0b0000'1000)) == 4);
}

出力

バージョン

言語

  • C++26

処理系

関連項目

参照