Export (0) Print
Expand All

StrIsIntlEqual function

Compares a specified number of characters from the beginning of two strings to determine if they are equal.

Syntax


BOOL StrIsIntlEqual(
  BOOL fCaseSens,
  _In_  PCTSTR pszString1,
  _In_  PCTSTR pszString2,
  int nChar
);

Parameters

fCaseSens

Type: BOOL

The case sensitivity of the comparison. If this value is nonzero, the comparison is case-sensitive. If this value is zero, the comparison is not case-sensitive.

pszString1 [in]

Type: PCTSTR

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

pszString2 [in]

Type: PCTSTR

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

nChar

Type: int

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

Return value

Type: BOOL

TRUE if the first nChar characters from the two strings are equal; otherwise, FALSE.

Remarks

You can set case sensitivity with the StrIntlEqN and StrIntlEqNI macros. StrIntlEqN performs a case-sensitive comparison, and StrIntlEqNI performs a case-insensitive comparison.

The syntax of the two macros is:


#define StrIntlEqN(s1, s2, nChar) StrIsIntlEqual(TRUE, s1, s2, nChar)
#define StrIntlEqNI(s1, s2, nChar) StrIsIntlEqual(FALSE, s1, s2, nChar)

Requirements

Minimum supported client

Windows 2000 Professional, Windows XP [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Shlwapi.h

Library

Shlwapi.lib

DLL

Shlwapi.dll (version 4.71 or later)

Unicode and ANSI names

StrIsIntlEqualW (Unicode) and StrIsIntlEqualA (ANSI)

 

 

Community Additions

ADD
Show:
© 2014 Microsoft