CompareMemoryString

CompareMemoryString()

Syntaxe

Resultat = CompareMemoryString(*Texte1, *Texte2 [, Mode [, Longueur [, Options]]])

Description

Compare deux chaînes de caractères situées en mémoire.

Arguments

*Texte1, *Texte2 Les adresses des deux chaînes de caractères à comparer.
Mode (optionnel)
Peut prendre l'une des valeurs suivantes:
  #PB_String_CaseSensitive : La recherche est sensible à  la casse (a=a) (Par défaut).
  #PB_String_NoCase        : Comparaison insensible à la casse (a=A).
  #PB_String_NoCaseAscii   : Recherche insensible à la casse utilisant uniquement le jeu de caractères ascii (a=A). 
                             Beaucoup plus rapide que #PB_String_NoCase lorsque la prise en charge complète d'Unicode n'est pas requise.
Longueur (optionnel) Le nombre de caractères à comparer.

Si ce paramètre ne est pas spécifié ou égal à -1 alors les chaînes sont comparées jusqu'à ce qu'un caractère #Null soit atteint.
Si les chaînes ne sont pas terminées par un caractère #Null, ce paramètre doit alors être spécifié.
Options (optionnel)
Peut prendre l'une des valeurs suivantes:
  #PB_Ascii  : Compare la chaîne de caractères au format ASCII
  #PB_UTF8   : Compare la chaîne de caractères au format  UTF-8
  #PB_Unicode: Compare la chaîne de caractères au format  Unicode
La valeur par défaut est #PB_Unicode.

Valeur de retour

Renvoie l'une des valeurs suivantes:

  #PB_String_Equal  : Le 'Texte1' est égal au 'Texte2'.
  #PB_String_Lower  : Le 'Texte1' est inférieur au 'Texte2'.
  #PB_String_Greater: Le 'Texte1' est supérieur au 'Texte2'.

Exemple

  Texte1$ = "OK"
  Texte2$ = "KO"

  Comp = CompareMemoryString(@Texte1$, @Texte2$)
  Select Comp
    Case #PB_String_Equal
      Debug "Le 'Texte1' est égal au 'Texte2'."
    Case #PB_String_Lower  
      Debug "Le 'Texte1' est inférieur au 'Texte2'."
    Case #PB_String_Greater
      Debug "Le 'Texte1' est supérieur au 'Texte2'."
  EndSelect

Voir aussi

PokeS(), PeekS(), MemoryStringLength(), CopyMemoryString(), CompareMemory(), MemorySize()

OS Supportés

Tous

<- CompareMemory() - Memory Index - CopyMemory() ->

Texte1, Texte2	Les adresses des deux chaînes de caractères à comparer.
Mode (optionnel)	Peut prendre l'une des valeurs suivantes: #PB_String_CaseSensitive : La recherche est sensible à la casse (a=a) (Par défaut). #PB_String_NoCase : Comparaison insensible à la casse (a=A). #PB_String_NoCaseAscii : Recherche insensible à la casse utilisant uniquement le jeu de caractères ascii (a=A). Beaucoup plus rapide que #PB_String_NoCase lorsque la prise en charge complète d'Unicode n'est pas requise.
Longueur (optionnel)	Le nombre de caractères à comparer. Si ce paramètre ne est pas spécifié ou égal à -1 alors les chaînes sont comparées jusqu'à ce qu'un caractère #Null soit atteint. Si les chaînes ne sont pas terminées par un caractère #Null, ce paramètre doit alors être spécifié.
Options (optionnel)	Peut prendre l'une des valeurs suivantes: #PB_Ascii : Compare la chaîne de caractères au format ASCII #PB_UTF8 : Compare la chaîne de caractères au format UTF-8 #PB_Unicode: Compare la chaîne de caractères au format Unicode La valeur par défaut est #PB_Unicode.