_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
| Nieodłączny | 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