_BitScanForward, _BitScanForward64

Статья
06/10/2015

Блок, относящийся только к системам Microsoft

Поиск данных маски от наименьшего значащего разряда (LSB) к наибольшему значащему разряду (MSB) для значащего разряда (1).

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

Параметры

[выходной] Index
Загруженный с позиции разряда первый значащий разряд (1) найден.
[in] Mask
32-разрядное или 64-разрядное значение для поиска.

Возвращаемое значение

0, если маска равна нулю; ненулевое значение в противном случае.

Заметки

Если найден значащий разряд, положение разряда первого найденного значащего разряда возвращается в качестве первого параметра. Если значащий разряд не найден, возвращается 0; в противном случае возвращается 1.

Требования

Встроенная функция	Архитектура
_BitScanForward	x86, ARM, x64
_BitScanForward64	ARM, x64

Файл заголовка <intrin.h>

Пример

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

См. также

Ссылки

Встроенные объекты компилятора

Поделиться через