_BitScanForward, _BitScanForward64

Specyficzne dla firmy Microsoft

Przeszukaj dane maski z najmniej znaczącego bitu (LSB) do najbardziej znaczącego bitu (MSB) dla ustawionego bitu (1).

Składnia

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

Parametry

Indeks
[out] Załadowany z pozycją bitów pierwszego zestawu (1) znaleziony.

Maska
[in] Wartość 32-bitowa lub 64-bitowa do wyszukania.

Wartość zwracana

0, jeśli maska ma wartość zero; w przeciwnym razie niezero.

Uwagi

W przypadku znalezienia bitu ustawionego pozycja bitu pierwszego zestawu jest zapisywana na adres określony w pierwszym parametrze, a funkcja zwraca wartość 1. Jeśli bit nie zostanie znaleziony, funkcja zwróci wartość 0, a wartość zapisana w adresie w pierwszym parametrze jest niezdefiniowana.

Wymagania

Wewnętrzne	Architektura
_BitScanForward	x86, ARM, x64, ARM64
_BitScanForward64	ARM64, x64

Plik<nagłówka intrin.h>

Przykład

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

END Microsoft Specific

Zobacz też

Funkcje wewnętrzne kompilatora