stdc_leading_zeros

 

C

コンパイラサポート

言語

ヘッダー

型サポート

プログラムユーティリティ

可変長引数関数のサポート

エラーハンドリング

動的メモリ管理

文字列ライブラリ

アルゴリズム

数値

日付と時刻のユーティリティ

入出力サポート

ローカライゼーションサポート

並行処理サポート (C11)

技術仕様

シンボルインデックス

 

数値

共通の数学関数

浮動小数点環境 (C99)

擬似乱数生成

複素数演算 (C99)

型ジェネリックな数学関数 (C99)

ビット操作 (C23)

整数オーバーフロー検査 (C23)

 

ビット操作

関数

stdc_leading_zeros (C23)

stdc_leading_ones (C23)

stdc_trailing_zeros (C23)

stdc_trailing_ones (C23)

stdc_first_leading_zero (C23)

stdc_first_leading_one (C23)

stdc_first_trailing_zero (C23)

stdc_first_trailing_one (C23)

stdc_count_zeros (C23)

stdc_count_ones (C23)

stdc_has_single_bit (C23)

stdc_bit_width (C23)

stdc_bit_floor (C23)

stdc_bit_ceil (C23)

マクロ定数

__STDC_ENDIAN_LITTLE__ __STDC_ENDIAN_BIG__ __STDC_ENDIAN_NATIVE__ (C23)(C23)(C23)

 

ヘッダー <stdbit.h> で定義されています。
unsigned int stdc_leading_zeros_uc( unsigned char value ) [[unsequenced]];	(1)	(C23以降)
unsigned int stdc_leading_zeros_us( unsigned short value ) [[unsequenced]];	(2)	(C23以降)
unsigned int stdc_leading_zeros_ui( unsigned int value ) [[unsequenced]];	(3)	(C23以降)
unsigned int stdc_leading_zeros_ul( unsigned long int value ) [[unsequenced]];	(4)	(C23以降)
unsigned int stdc_leading_zeros_ull( unsigned long long int value ) [[unsequenced]];	(5)	(C23以降)
#define stdc_leading_zeros( value ) // 公開インターフェース generic_return_type stdc_leading_zeros( generic_value_type value ) [[unsequenced]];	(6)	(C23以降)

1-5) 最上位ビットから始まる、連続する ​0​ ビットの数を返します。

6) 型汎用関数（generic_value_type 引数でマークされている）は、入力値の型に基づいて適切な値を返します。ただし、それは次のいずれかである必要があります。

• 標準の符号なし整数型（bool を除く）。
• 拡張符号なし整数型。
• または、標準または拡張整数型（bool を除く）の幅に一致する、ビット精度の符号なし整数型。

generic_return_type は、計算された結果を表現できる適切な大きな符号なし整数型である必要があります。

パラメータ

value

-

符号なし整数型の値

戻り値

最上位ビットから始まる、連続する ​0​ ビットの数。

例

このコードを実行

#include <limits.h>
#include <stdbit.h>
#include <stdint.h>
#include <stdio.h>
 
#define bits_num(value) (sizeof(value) * CHAR_BIT)
 
#define bin_impl(T, suffix) \
const char* bin_##suffix(T x) \
{ \
    static char buf[bits_num(x) * CHAR_BIT + 1]; \
    for (T i = 0, mask = ((T)1 << (bits_num(x) - 1)); mask; mask >>= 1) \
        buf[i++] = x & mask ? '1' : '0'; \
    buf[bits_num(x)] = '\0'; \
    return buf; \
}
 
bin_impl(uint8_t, u8)
bin_impl(uint16_t, u16)
bin_impl(uint32_t, u32)
bin_impl(uint64_t, u64)
 
#define bin(x) _Generic((x), \
    uint8_t: bin_u8, uint16_t: bin_u16, uint32_t: bin_u32, default: bin_u64)(x)
 
int main()
{
    puts("uint8_t:");
    for (uint8_t x = 0b11000000; ; x >>= 1)
    {
        printf("x = [%s], leading zeros: %d\n", bin(x), stdc_leading_zeros(x));
        if (!x)
            break;
    }
 
    puts("uint16_t:");
    for (uint16_t x = 0b11000000; ; x >>= 1)
    {
        printf("x = [%s], leading zeros: %d\n", bin(x), stdc_leading_zeros(x));
        if (!x)
            break;
    }
}

出力

uint8_t:
x = [11000000], leading zeros: 0
x = [01100000], leading zeros: 1
x = [00110000], leading zeros: 2
x = [00011000], leading zeros: 3
x = [00001100], leading zeros: 4
x = [00000110], leading zeros: 5
x = [00000011], leading zeros: 6
x = [00000001], leading zeros: 7
x = [00000000], leading zeros: 8
uint16_t:
x = [0000000011000000], leading zeros: 8
x = [0000000001100000], leading zeros: 9
x = [0000000000110000], leading zeros: 10
x = [0000000000011000], leading zeros: 11
x = [0000000000001100], leading zeros: 12
x = [0000000000000110], leading zeros: 13
x = [0000000000000011], leading zeros: 14
x = [0000000000000001], leading zeros: 15
x = [0000000000000000], leading zeros: 16

関連項目

stdc_first_leading_zero (C23)	最上位ビットから始まる ​0​ ビットの最初の位置を見つけます (型汎用関数マクロ)
stdc_count_zeros (C23)	符号なし整数内の ​0​ ビットの数を数えます (型汎用関数マクロ)
stdc_leading_ones (C23)	最上位ビットから始まる連続する 1 ビットの数を数えます (型汎用関数マクロ)
C++ ドキュメント for countl_zero