CHString::CompareNoCase method (chstring.h)

Article
02/22/2024

[The CHString class is part of the WMI Provider Framework which is now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.]

The CompareNoCase method uses the _wcsicmp function to compare a CHString string with another string.

Syntax

int CompareNoCase(
  LPCWSTR lpsz
);

Parameters

lpsz

The other string used for comparison.

Return value

The CompareNoCase method returns the following values.

Remarks

The CompareNoCase method, which performs a case-insensitive comparison of the strings, is not affected by locale.

Examples

The following code example shows the use of CHstring::CompareNoCase:

CHString s1( L"abc" );
CHString s2( L"ABD" );

// Compare with a CHString.
assert( s1.CompareNoCase( s2 ) == 0 );
// Compare with LPCWSTR string.
assert( s1.CompareNoCase( L"ABE" ) < 0 );

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Target Platform	Windows
Header	chstring.h (include FwCommon.h)
Library	FrameDyn.lib
DLL	FrameDynOS.dll; FrameDyn.dll