_BitScanForward, _BitScanForward64

Статья
10/12/2023

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

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

Синтаксис

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

Параметры

Указатель
[out] Загружена битовая позиция первого набора (1) найдена.

Маска
[in] 32-разрядное или 64-разрядное значение для поиска.

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

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

Замечания

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

Требования

Intrinsic	Архитектура
`_BitScanForward`	x86, ARM, x64, ARM64
`_BitScanForward64`	ARM64, 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

Завершение блока, относящегося только к системам Майкрософт

См. также

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

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