_BitScanForward、_BitScanForward64

[このドキュメントはプレビュー版であり、後のリリースで変更されることがあります。 Blank topics are included as placeholders.]

Microsoft 固有の仕様 →

設定のビット (1) を最下位 (LSB) ビットの最上位ビットに (MSB) マスクのデータを検索します。

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

パラメーター

• [出力] Index
  最初の設定のビット (1) のビット位置に読み込まれる使用します。

• [入力] Mask
  検索する 32 ビットまたは 64 ビットの値。

戻り値

マスクがゼロの場合は0; 以外を返します。

解説

設定がある場合最初のパラメーターの検索された最初のビット位置を返します。 設定が見つからなかった場合は- 0 が返されます ; それ以外の場合は 1 を返します。

必要条件

ヘッダー ファイル <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

参照

Reference

コンパイラ組み込み関数。