_BitScanForward、_BitScanForward64

  • 项目

Microsoft 专用

从设置位 (1) 的最低有效位 (LSB) 到最高有效位 (MSB) 搜索掩码数据。

语法

unsigned char _BitScanForward(
   unsigned long * Index,
   unsigned long Mask
);
unsigned char _BitScanForward64(
   unsigned long * Index,
   unsigned __int64 Mask
);

参数

Index
[out] 加载已找到的第一个设置位 (1) 的数位位置。

掩码
[in] 要搜索的 32 位或 64 位值。

返回值

如果掩码为零，则为 0；否则为非零值。

备注

如果找到集位，则第一个集位的位位置将写入第一个参数中指定的地址，并且函数返回 1。 如果未找到位，该函数将返回 0，并且写入到第一个参数中的地址的值未定义。

要求

Intrinsic 体系结构
_BitScanForward x86、ARM、x64、ARM64
_BitScanForward64 ARM64、x64

头文件<intrin.h>

示例

// BitScanForward.cpp
// compile with: /EHsc
#include <iostream>
#include <intrin.h>
using namespace std;

#pragma intrinsic(_BitScanForward)

int main()
{
   unsigned long mask = 0x1000;
   unsigned long index;
   unsigned char isNonzero;

   cout << "Enter a positive integer as the mask: " << flush;
   cin >> mask;
   isNonzero = _BitScanForward(&index, mask);
   if (isNonzero)
   {
      cout << "Mask: " << mask << " Index: " << index << endl;
   }
   else
   {
      cout << "No set bits found.  Mask is zero." << endl;
   }
}

12

Enter a positive integer as the mask:
Mask: 12 Index: 2

结束 Microsoft 专用

另请参阅

编译器内部函数