_BitScanForward, _BitScanForward64

Artigo
06/10/2015

Específico 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).

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

Parâmetros

[out] Index
Carregado com a posição de bit do primeiro bit do conjunto (1) encontrado.
[in] Mask
O valor de 32 bits ou 64 bits a pesquisar.

Valor de retorno

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

Comentários

Se bit definido for encontrado, a posição de bit do primeiro bit definido encontrado será retornada ao primeiro parâmetro. Se nenhum bit definido for encontrado, 0 será retornado; caso contrário, 1.

Requisitos

Intrínseco	Arquitetura
_BitScanForward	x86, ARM, x64
_BitScanForward64	ARM, x64

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

Entrada

Exemplo de saída

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

Consulte também

Referência

Intrínsecos do compilador

Partilhar via