StrIsIntlEqualA, fonction (shlwapi.h)

Article
03/04/2024

Compare un nombre spécifié de caractères du début de deux chaînes pour déterminer s’ils sont égaux.

Syntaxe

BOOL StrIsIntlEqualA(
       BOOL  fCaseSens,
  [in] PCSTR pszString1,
  [in] PCSTR pszString2,
       int   nChar
);

Paramètres

fCaseSens

Type : BOOL

Respect de la casse de la comparaison. Si cette valeur est différente de zéro, la comparaison respecte la casse. Si cette valeur est égale à zéro, la comparaison ne respecte pas la casse.

[in] pszString1

Type : PCTSTR

Pointeur vers la première chaîne terminée par null à comparer.

[in] pszString2

Type : PCTSTR

Pointeur vers la deuxième chaîne terminée par null à comparer.

nChar

Type : int

Nombre de caractères du début de chaque chaîne à comparer.

Valeur retournée

Type : BOOL

TRUE si les premiers caractères nChar des deux chaînes sont égaux ; sinon, FALSE.

Remarques

Vous pouvez définir le respect de la casse avec les macros StrIntlEqN et StrIntlEqNI . StrIntlEqN effectue une comparaison respectant la casse, et StrIntlEqNI effectue une comparaison qui ne respecte pas la casse.

La syntaxe des deux macros est la suivante :

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

Notes

L’en-tête shlwapi.h définit StrIsIntlEqual en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlwapi.h
Bibliothèque	Shlwapi.lib
DLL	Shlwapi.dll (version 4.71 ou ultérieure)

Partager via