XMComparisonMixed function (directxmath.h)

Article
02/22/2024

Tests the comparison value to determine if the compared components had mixed results--some true and some false.

Syntax

bool XMComparisonMixed(
  [in] uint32_t CR
) noexcept;

Parameters

[in] CR

Comparison value to test. The comparison value is typically retrieved using a recording version of a DirectXMath function such as XMVector4EqualR. The names of the recording functions end with an "R".

Return value

Returns true if some of the compared components are true and some of the compared components are false.

Remarks

The following code snippet highlights how this function might be used:

uint32_t comparisonValue = XMVector4EqualR( V1, V2 );
if( XMComparisonMixed( comparisonValue ) )
{
	DoStuff();
}

The DoStuff function will be called only if some of the components of V1 and V2 are different and some of the components are the same. The DoStuff function will not be called if all of the components are equal, nor will it be called if all of the components are different.

Platform Requirements

Microsoft Visual Studio 2010 or Microsoft Visual Studio 2012 with the Windows SDK for Windows 8. Supported for Win32 desktop apps, Windows Store apps, and Windows Phone 8 apps.

Requirements

Requirement	Value
Target Platform	Windows
Header	directxmath.h