Date de parution : 28/10/2000
- Cette fiche API a été lue 1774 fois
Description
CompareString compare deux chaînes et détermine laquelle devra venir en premier dans l'ordre alphabétique. La fonction peut utiliser un certain nombre d'opérateurs de comparaison différent, par défaut le tri est casse-sensible.
Identifiant local pour l'utilisation de la comparaison. Un des sémaphores suivant :
LOCALE_SYSTEM_DEFAULT = 0x400
Thread système par défaut.
LOCALE_USER_DEFAULT = 0x800
Thread utilisateur par défaut.
dwCmpFlags
Une combinaison des sémaphores suivants. Pour l'opérateur de comparaison par défaut, laisser le paramètre à 0.
NORM_IGNORECASE = 0x1
Ignore la casse.
NORM_IGNOREKANATYPE = 0x10000
Pour les caractères japonnais, aucun distinction entre les caractères Hiragana et Katakana.
NORM_IGNORENONSPACE = 0x2
Ignore caractères qui ne sont des espaces.
NORM_IGNORESYMBOLS = 0x4
Ignore les symboles.
NORM_IGNOREWIDTH = 0x20000
Aucune distinction entre les caractères sur un octet simple et double.
SORT_STRINGSORT = 0x1000
Trie la chaîne en incluant tous les symboles (traits d'union et apostrophes), ceux-ci venant en premier.
lpString1
Première chaîne à comparer.
cchCount1
Longueur de lpString1. Si elle est à -1, lpString1 doit se terminer par un caractère terminateur à Null.
lpString2
Second chaîne à comparer.
cchCount2
Idem que cchCount1.
Compatibilité
Windows 95 : supporté
Windows 98 :
supporté
Windows NT :
demande Windows NT 3.1 ou plus
Windows 2000 :
supporté
Windows CE :
demande Windows CE 1.0 ou plus
Remarque
Exemple 1
// Trions les valeurs d'un tableau alphabétiquement en ordre // croissant en respectant la casse (minuscule d'abord puis majuscule)
TablMot
est un tableau de 10 chaînes fixes sur 25 TempCh est une chaîne // chaîne tampon pour le tri oc, ic sont des entiers courts // compteurs CompVal est un entier long // résultat de la comparaison threadLocale est un entier long // Id de la thread
// Liste des opérateurs de comparaison // LESS_THAN = 1 Opérateur plus petit que // CSTR_EQUAL = 2 Opérateur égal à CSTR_GREATER_THAN est un entier = 3 // Opérateur plus grand que