Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

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)

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.