Fonction StrCmpLogicalW (shlwapi.h)

Article
03/02/2024

Compare deux chaînes Unicode. Les chiffres dans les chaînes sont considérés comme du contenu numérique plutôt que comme du texte. Ce test ne respecte pas la casse.

Syntaxe

int StrCmpLogicalW(
  [in] PCWSTR psz1,
  [in] PCWSTR psz2
);

Paramètres

[in] psz1

Type : PCWSTR

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

[in] psz2

Type : PCWSTR

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

Valeur retournée

Type : int

Retourne zéro si les chaînes sont identiques.
Retourne 1 si la chaîne pointée par psz1 a une valeur supérieure à celle pointée par psz2.
Retourne -1 si la chaîne pointée par psz1 a une valeur inférieure à celle pointée par psz2.

Remarques

Le schéma de classement de cette fonction diffère quelque peu de StrCmpI, qui compare également les chaînes sans tenir compte du respect de la casse. Si l’on considère les chiffres par leur valeur numérique, comme le fait StrCmpLogicalW , les chaînes sont triées comme suit :

2string
3string
20string
st2ring
st3ring
st20ring
string2
string3
string20

StrCmpI considère les chiffres de la chaîne uniquement comme du texte afin que ces mêmes chaînes soient triées comme suit :

20string
2string
3string
st20ring
st2ring
st3ring
string2
string20
string3

Note Le comportement de cette fonction, et par conséquent les résultats qu’elle retourne, peut changer de mise en production. Il ne doit pas être utilisé pour les applications de tri canonique.

Configuration requise

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

Partager via