aboutsummaryrefslogtreecommitdiff
path: root/thirdparty/raw_pdb/src/Foundation/PDB_BitUtil.h
blob: 7dc5ee3e9c596e6a8049c79abc8f63ba71481b61 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
// Copyright 2011-2022, Molecular Matters GmbH <[email protected]>
// See LICENSE.txt for licensing details (2-clause BSD License: https://opensource.org/licenses/BSD-2-Clause)

#pragma once

#include "PDB_Assert.h"

#ifdef _WIN32
	PDB_PUSH_WARNING_CLANG
	PDB_DISABLE_WARNING_CLANG("-Wreserved-identifier")

	extern "C" unsigned char _BitScanForward(unsigned long* _Index, unsigned long _Mask);

	PDB_POP_WARNING_CLANG

#	if PDB_COMPILER_MSVC
#		pragma intrinsic(_BitScanForward)
#	endif
#endif


namespace PDB
{
	namespace BitUtil
	{
		// Returns whether the given unsigned value is a power of two.
		template <typename T>
		PDB_NO_DISCARD inline constexpr bool IsPowerOfTwo(T value) PDB_NO_EXCEPT
		{
			PDB_ASSERT(value != 0u, "Invalid value.");

			return (value & (value - 1u)) == 0u;
		}


		// Rounds the given unsigned value up to the next multiple.
		template <typename T>
		PDB_NO_DISCARD inline constexpr T RoundUpToMultiple(T numToRound, T multipleOf) PDB_NO_EXCEPT
		{
			PDB_ASSERT(IsPowerOfTwo(multipleOf), "Multiple must be a power-of-two.");

			return (numToRound + (multipleOf - 1u)) & ~(multipleOf - 1u);
		}


		// Finds the position of the first set bit in the given value starting from the LSB, e.g. FindFirstSetBit(0b00000010) == 1.
		// This operation is also known as CTZ (Count Trailing Zeros).
		template <typename T>
		PDB_NO_DISCARD inline uint32_t FindFirstSetBit(T value) PDB_NO_EXCEPT;

		template <>
		PDB_NO_DISCARD inline uint32_t FindFirstSetBit(uint32_t value) PDB_NO_EXCEPT
		{
			PDB_ASSERT(value != 0u, "Invalid value.");

#ifdef _WIN32
			unsigned long result = 0ul;

			_BitScanForward(&result, value);
#else
			unsigned int result = 0u;

			result = static_cast<unsigned int>(__builtin_ffs(static_cast<int>(value)));
			if (result)
			{
				--result;
			}
#endif

			return result;
		}
	}
}