_BitScanForward, _BitScanForward64

Artikel
06/10/2015

Microsoft-spezifisch

Suchen Sie die Maskendaten vom niedrigstwertigen Bit (LSB) bis zum höchstwertigen Bit (MSB) für ein festgelegtes Bit (1).

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

Parameter

[out] Index
Geladen mit der Bitposition des ersten festgelegten Bits (1), das ermittelt wurde.
[in] Mask
Der zu suchende 32-Bit- oder 64-Bit-Wert.

Rückgabewert

0, wenn die Maske null ist; andernfalls ungleich null.

Hinweise

Wenn ein festgelegtes Bit gefunden wird, wird die Bitposition des ersten festgelegten gefundenen Bits in den ersten Parameter zurückgegeben. Wenn kein festgelegtes Bit gefunden wird, wird 0 zurückgegeben; andernfalls wird 1 zurückgegeben.

Anforderungen

Systemintern	Architektur
_BitScanForward	x86, ARM, x64
_BitScanForward64	ARM, x64

Headerdatei <intrin.h>

Beispiel

// 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;
   }
}

Eingabe

Beispielausgabe

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

Siehe auch

Referenz

Intrinsische Compilerfunktionen

Freigeben über