_BitScanForward, _BitScanForward64

Seção específica da Microsoft

Pesquise os dados de máscara do bit menos significativo (LSB) para o bit mais significativo (MSB) para um conjunto de bits (1).

Sintaxe

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

Parâmetros

Index
[out] Carregado com a posição de bit do primeiro bit do conjunto (1) encontrado.

Máscara
[in] O valor de 32 bits ou 64 bits a pesquisar.

Valor retornado

0 se a máscara for zero. diferente de zero, caso contrário.

Comentários

Se um bit definido for encontrado, a posição do bit do primeiro bit definido será gravada no endereço especificado no primeiro parâmetro e a função retornará 1. Se nenhum bit for encontrado, a função retornará 0 e o valor gravado no endereço no primeiro parâmetro será indefinido.

Requisitos

Arquivo de cabeçalho<intrin.h>

Exemplo

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

Fim da seção específica da Microsoft

Confira também

Intrínsecos do compilador