共用方式為

_BitScanForward _BitScanForward64

  • 發行項

Microsoft 特定的

從遮罩資料的最低有效位元 (MSB) 到最高有效位元 (LSB) 搜尋設定位元 (1)。

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

參數

  • [輸出] Index
    會使用找到的第一個設定位元 (1) 的位元位置載入。

  • [in] Mask
    要搜尋的 32 位元或 64 位元值。

傳回值

如果遮罩是零，則為 0；否則為非零。

備註

如果找到設定位元，會在第一個參數中傳回找到的第一個設定位元的位元位置。 如果找不到設定位元，就會傳回 0；否則，會傳回 1。

需求

內建

架構

_BitScanForward

x86、ARM、x64

_BitScanForward64

ARM、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

請參閱

參考

編譯器內建