Description:

Operators available to elements of enumerations if T_EnumIsBitwise is specialized.

Note: This namespace exits only in the documentation to collect the operators. When parsed by a C++ compiler, the operators reside in the global namespace and functions HasBits, CountElements, ToBitwiseEnumeration and ToSequentialEnumeration reside in namespace alib.

As required, when parsed by a C++ compiler, the operators reside in the global namespace.

Function Index:
template<typename TEnum >
static constexpr int	CountElements (TEnum value)

template<typename TEnum >
constexpr bool	HasBits (TEnum element, TEnum selection) noexcept

template<typename TEnum >
constexpr bool	HasOneOf (TEnum element, TEnum selection) noexcept

template<typename TEnum >
constexpr TEnum	operator& (TEnum lhs, TEnum rhs) noexcept

template<typename TEnum >
constexpr TEnum	operator&= (TEnum &lhs, TEnum rhs) noexcept

template<typename TEnum >
constexpr TEnum	operator+ (TEnum lhs, TEnum rhs) noexcept

template<typename TEnum >
constexpr TEnum	operator+= (TEnum &lhs, TEnum rhs) noexcept

template<typename TEnum >
constexpr TEnum	operator- (TEnum lhs, TEnum rhs) noexcept

template<typename TEnum >
constexpr TEnum	operator-= (TEnum &lhs, TEnum rhs) noexcept

template<typename TEnum >
constexpr TEnum	operator^ (TEnum lhs, TEnum rhs) noexcept

template<typename TEnum >
constexpr TEnum	operator^= (TEnum &lhs, TEnum rhs) noexcept

template<typename TEnum >
constexpr TEnum	operator\| (TEnum lhs, TEnum rhs) noexcept

template<typename TEnum >
constexpr bool	operator\|= (TEnum &lhs, TEnum rhs) noexcept

template<typename TEnum >
constexpr TEnum	operator~ (TEnum op) noexcept

template<typename TEnum >
constexpr TEnum	ToBitwiseEnumeration (typename std::underlying_type< TEnum >::type number)

template<typename TEnum >
static constexpr std::underlying_type< TEnum >::type	ToSequentialEnumeration (TEnum element)

Function Details:

◆ CountElements()

template<typename TEnum >

static constexpr int CountElements ( TEnum value )

staticconstexpr

Returns the number of bitwise enumeration elements set in the given value. In other words, the bits given in value are counted and the number is returned.

Selected by the compiler only if T_EnumIsBitwise is specialized for template enum type TEnum to inherit std::true_type.

Parameters

value A single or composite selection of bits.

Returns: The result of a call to alib::lang::BitCount().

Here is the call graph for this function:

◆ HasBits()

template<typename TEnum >

bool HasBits	(	TEnum	element,
		TEnum	selection )

constexprnoexcept

Tests if the integral value of the given enum element contains all bits set in selection. In other words, returns result of:

  ( element & selection ) == selection

Selected by the compiler only if T_EnumIsBitwise is specialized for template enum type TEnum to inherit std::true_type.

Template Parameters

TEnum Enumeration type. Deduced by the compiler.

Parameters

element	Bitset to be tested.
selection	Second operand.

Returns: true if all bits of selection are set in element.

Here is the call graph for this function:

◆ HasOneOf()

template<typename TEnum >

bool HasOneOf	(	TEnum	element,
		TEnum	selection )

constexprnoexcept

Tests if the integral value of the given enum element contains at least one of the bits set in selection. In other words, returns result of:

  ( element & selection ) != 0

Selected by the compiler only if T_EnumIsBitwise is specialized for template enum type TEnum to inherit std::true_type.

Template Parameters

TEnum Enumeration type. Deduced by the compiler.

Parameters

element	Bitset to be tested.
selection	Second operand.

Returns: true if one of the bits of selection are set in element.

Here is the call graph for this function:

◆ operator&()

template<typename TEnum >

TEnum operator&	(	TEnum	lhs,
		TEnum	rhs )

constexprnoexcept

Bitwise and operator usable with scoped enum types.
Selected by the compiler only if T_EnumIsBitwise is specialized for template enum type TEnum to inherit std::true_type.

Template Parameters

TEnum Enumeration type.

Parameters

lhs	First operand.
rhs	Second operand.

Returns: The result of a bitwise and operation of the underlying enum values.

Definition at line 152 of file bitwise.hpp.

◆ operator&=()

template<typename TEnum >

TEnum operator&=	(	TEnum &	lhs,
		TEnum	rhs )

constexprnoexcept

Bitwise assignment operator usable with scoped enum types.
Selected by the compiler only if T_EnumIsBitwise is specialized for template enum type TEnum to inherit std::true_type.

Template Parameters

TEnum Enumeration type.

Parameters

[in,out]	lhs	Reference to the first operand. Receives the result.
	rhs	Second operand.

Returns: The new value of lhs which is set to lhs & rhs.

Definition at line 173 of file bitwise.hpp.

◆ operator+()

template<typename TEnum >

TEnum operator+	(	TEnum	lhs,
		TEnum	rhs )

constexprnoexcept

Alias to bitwise or operator usable with scoped enum types.
Selected by the compiler only if T_EnumIsBitwise is specialized for template enum type TEnum to inherit std::true_type and if T_EnumIsArithmetical is not specialized to inherit std::true_type. The latter is to avoid ambiguities in situations where an enum is both, arithmetical and bitwise.

Template Parameters

TEnum Enumeration type.

Parameters

lhs	First operand.
rhs	Second operand.

Returns: The result of a bitwise or operation of the underlying enum values.

Definition at line 306 of file bitwise.hpp.

◆ operator+=()

template<typename TEnum >

TEnum operator+=	(	TEnum &	lhs,
		TEnum	rhs )

constexprnoexcept

Alias for bitwise or assignment operator usable with scoped enum types.
Selected by the compiler only if T_EnumIsBitwise is specialized for template enum type TEnum to inherit std::true_type and if T_EnumIsArithmetical is not specialized to inherit std::true_type. The latter is to avoid ambiguities in situations where an enum is both, arithmetical and bitwise.

Template Parameters

TEnum Enumeration type.

Parameters

[in,out]	lhs	Reference to the first operand. Receives the result.
	rhs	Second operand.

Returns: The new value of lhs which is set to lhs | rhs.

Definition at line 330 of file bitwise.hpp.

◆ operator-()

template<typename TEnum >

TEnum operator-	(	TEnum	lhs,
		TEnum	rhs )

constexprnoexcept

Removes bit(s) found in rhs from lhs an returns result. This is a shortcut to:

 lhs & !rhs

Selected by the compiler only if T_EnumIsBitwise is specialized for template enum type TEnum to inherit std::true_type and if T_EnumIsArithmetical is not specialized to inherit std::true_type. The latter is to avoid ambiguities in situations where an enum is both, arithmetical and bitwise.

Template Parameters

TEnum Enumeration type.

Parameters

lhs	First operand.
rhs	Second operand.

Returns: The result of lhs & !rhs.

Definition at line 357 of file bitwise.hpp.

◆ operator-=()

template<typename TEnum >

TEnum operator-=	(	TEnum &	lhs,
		TEnum	rhs )

constexprnoexcept

Removes bit(s) found in rhs from lhs. This is a shortcut to:

 lhs &= !rhs

Selected by the compiler only if T_EnumIsBitwise is specialized for template enum type TEnum to inherit std::true_type and if T_EnumIsArithmetical is not specialized to inherit std::true_type. The latter is to avoid ambiguities in situations where an enum is both, arithmetical and bitwise.

Template Parameters

TEnum Enumeration type.

Parameters

[in,out]	lhs	Reference to the first operand. Receives the result.
	rhs	Second operand.

Returns: The new value of lhs which is set to lhs & ( ~rhs ).

Definition at line 384 of file bitwise.hpp.

◆ operator^()

template<typename TEnum >

TEnum operator^	(	TEnum	lhs,
		TEnum	rhs )

constexprnoexcept

Bitwise xor operator usable with scoped enum types.
Selected by the compiler only if T_EnumIsBitwise is specialized for template enum type TEnum to inherit std::true_type.

Template Parameters

TEnum Enumeration type.

Parameters

lhs	First operand.
rhs	Second operand.

Returns: The result of a bitwise xor operation of the underlying enum values.

Definition at line 236 of file bitwise.hpp.

◆ operator^=()

template<typename TEnum >

TEnum operator^=	(	TEnum &	lhs,
		TEnum	rhs )

constexprnoexcept

Bitwise xor assignment operator usable with scoped enum types.
Selected by the compiler only if T_EnumIsBitwise is specialized for template enum type TEnum to inherit std::true_type.

Template Parameters

TEnum Enumeration type.

Parameters

[in,out]	lhs	Reference to the first operand. Receives the result.
	rhs	Second operand.

Returns: The new value of lhs which is set to lhs ^ rhs.

Definition at line 257 of file bitwise.hpp.

◆ operator|()

template<typename TEnum >

TEnum operator\|	(	TEnum	lhs,
		TEnum	rhs )

constexprnoexcept

Bitwise or operator usable with scoped enum types.
Selected by the compiler only if T_EnumIsBitwise is specialized for template enum type TEnum to inherit std::true_type.

Template Parameters

TEnum Enumeration type.

Parameters

lhs	First operand.
rhs	Second operand.

Returns: The result of a bitwise or operation of the underlying enum values.

Definition at line 194 of file bitwise.hpp.

◆ operator|=()

template<typename TEnum >

bool operator\|=	(	TEnum &	lhs,
		TEnum	rhs )

constexprnoexcept

Bitwise or assignment operator usable with scoped enum types.
Selected by the compiler only if T_EnumIsBitwise is specialized for template enum type TEnum to inherit std::true_type.

Template Parameters

TEnum Enumeration type.

Parameters

[in,out]	lhs	Reference to the first operand. Receives the result.
	rhs	Second operand.

Returns: The new value of lhs which is set to lhs | rhs.

Definition at line 215 of file bitwise.hpp.

◆ operator~()

template<typename TEnum >

TEnum operator~ ( TEnum op )

constexprnoexcept

Bitwise not operator usable with scoped enum types.
Selected by the compiler only if T_EnumIsBitwise is specialized for template enum type TEnum to inherit std::true_type.

Note: To remove one or more bits from a scoped enum value, operator &= with this operator applied to op can be used. A shortcut to this is given with operator-=.

Template Parameters

TEnum Enumeration type.

Parameters

op	The operand to be negated.

Returns: The result of a bitwise negation of op.

Definition at line 281 of file bitwise.hpp.

◆ ToBitwiseEnumeration()

template<typename TEnum >

TEnum ToBitwiseEnumeration ( typename std::underlying_type< TEnum >::type number )

inlineconstexpr

Returns the bitwise enumeration element of TEnum from a given sequential enumeration.

Selected by the compiler only if T_EnumIsBitwise is specialized for template enum type TEnum to inherit std::true_type.

See also: The reverse function ToSequentialEnumeration.

Template Parameters

TEnum An enumeration type which is defined to be "bitwise".

Parameters

number A sequentially enumerated number, for which the corresponding bitwise enumeration element is requested. bitwise enumeration.

Returns: Returns 1 << number.

Here is the call graph for this function:

◆ ToSequentialEnumeration()

template<typename TEnum >

static constexpr std::underlying_type< TEnum >::type ToSequentialEnumeration ( TEnum element )

inlinestaticconstexpr

Returns the sequentially enumerated number derived from the given bitwise enumeration value. In other words, the positon of the most significant bit set in the underlying integral of the given enum element is returned.
In debug-compilations an ALib assertion is raised in case that the given value is not a single enum element but a combination of bits.

Selected by the compiler only if T_EnumIsBitwise is specialized for template enum type TEnum to inherit std::true_type.

See also: The reverse function ToBitwiseEnumeration.

Template Parameters

TEnum A bitwise defined enumeration type. Deduced by the compiler.

Parameters

element An enumeration value.

Returns: The sequential number of an element of an enum type which is defined bitwise.

Here is the call graph for this function:

Description:

Function Index:

Function Details:

◆ CountElements()

◆ HasBits()

◆ HasOneOf()

◆ operator&()

◆ operator&=()

◆ operator+()

◆ operator+=()

◆ operator-()

◆ operator-=()

◆ operator^()

◆ operator^=()

◆ operator|()

◆ operator|=()

◆ operator~()

◆ ToBitwiseEnumeration()

◆ ToSequentialEnumeration()