VarCmp function (oleauto.h)

Compares two variants.

Syntax

HRESULT VarCmp(
  [in] LPVARIANT pvarLeft,
  [in] LPVARIANT pvarRight,
  [in] LCID      lcid,
  [in] ULONG     dwFlags
);

[in] pvarLeft

The first variant.

[in] pvarRight

The second variant.

[in] lcid

The locale identifier.

[in] dwFlags

The compare results option.

Value	Meaning
NORM_IGNORECASE 0x00000001	Ignore case.
NORM_IGNORENONSPACE 0x00000002	Ignore nonspace characters.
NORM_IGNORESYMBOLS 0x00000004	Ignore symbols.
NORM_IGNOREWIDTH 0x00000008	Ignore string width.
NORM_IGNOREKANATYPE 0x00000040	Ignore Kana type.
NORM_IGNOREKASHIDA 0x00040000	Ignore Arabic kashida characters.

This function can return one of these values.

Return code/value	Description
VARCMP_LT 0	pvarLeft is less than pvarRight.
VARCMP_EQ 1	The parameters are equal.
VARCMP_GT 2	pvarLeft is greater than pvarRight.
VARCMP_NULL 3	Either expression is NULL.

The function only compares the value of the variant types. It compares strings, integers, and floating points, but not arrays or records.

NORM_IGNOREWIDTH causes VarCmp to ignore the difference between half-width and full-width characters, as the following example demonstrates:

"Ｃａｔ"== "cat"

The full-width form is a formatting distinction used in Chinese and Japanese scripts.