StrCmpN function

Compares a specified number of characters from the beginning of two strings to determine if they are the same. The comparison is case-sensitive. The StrNCmp macro differs from this function in name only.

Syntax

int StrCmpN(
  _In_ PCTSTR psz1,
  _In_ PCTSTR psz2,
  _In_ int    nChar
);

Parameters

psz1 [in]

Type: PCTSTR

A pointer to the first null-terminated string to be compared.

psz2 [in]

Type: PCTSTR

A pointer to the second null-terminated string to be compared.

nChar [in]

Type: int

The number of characters from the beginning of each string to be compared.

Return value

Type: int

Returns zero if the strings are identical. Returns a positive value if the first nChar characters of the string pointed to by psz1 are greater than those from the string pointed to by psz2. It returns a negative value if the first nChar characters of the string pointed to by psz1 are less than those from the string pointed to by psz2.

Requirements