_BitScanForward, _BitScanForward64

Articolo
10/12/2023

Sezione specifica Microsoft

Cercare un bit impostato (1) nei dati di maschera dal bit meno significativo (LSB) al bit più significativo (MSB).

Sintassi

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

Parametri

Indice
[out] Caricato con la posizione di bit del primo bit impostato (1) trovato.

Maschera
[in] Valore a 32 bit o a 64 bit da cercare.

Valore restituito

0 se la maschera è zero; diverso da zero in caso contrario.

Osservazioni:

Se viene trovato un bit set, la posizione di bit del primo bit set viene scritta nell'indirizzo specificato nel primo parametro e la funzione restituisce 1. Se non viene trovato alcun bit, la funzione restituisce 0 e il valore scritto nell'indirizzo nel primo parametro non è definito.

Requisiti

Intrinsic	Architettura
`_BitScanForward`	x86, ARM, x64, ARM64
`_BitScanForward64`	ARM64, x64

Esempio

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

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

Fine sezione specifica Microsoft

Vedi anche

Intrinseci del compilatore

Condividi tramite