Strings.StrComp, méthode

Article
08/21/2007

Retourne -1, 0 ou 1, selon le résultat d'une comparaison de chaînes.

Espace de noms : Microsoft.VisualBasic
Assembly : Microsoft.VisualBasic (dans microsoft.visualbasic.dll)

Syntaxe

'Déclaration
Public Shared Function StrComp ( _
    String1 As String, _
    String2 As String, _
    <OptionalAttribute> Optional Compare As CompareMethod = CompareMethod.Binary _
) As Integer
'Utilisation
Dim String1 As String
Dim String2 As String
Dim Compare As CompareMethod
Dim returnValue As Integer

returnValue = Strings.StrComp(String1, String2, Compare)

public static int StrComp (
    string String1,
    string String2,
    [OptionalAttribute] CompareMethod Compare
)

public:
static int StrComp (
    String^ String1, 
    String^ String2, 
    [OptionalAttribute] CompareMethod Compare
)

public static int StrComp (
    String String1, 
    String String2, 
    /** @attribute OptionalAttribute() */ CompareMethod Compare
)

public static function StrComp (
    String1 : String, 
    String2 : String, 
    Compare : CompareMethod
) : int

Paramètres

String1
Obligatoire. Toute expression String valide.

String2
Obligatoire. Toute expression String valide.

Compare
Facultatif. Spécifie le type de comparaison de chaînes. Si Compare est omis, le paramètre Option Compare détermine le type de comparaison.

Valeur de retour

Si String1 est trié avant String2, , StrComp retourne -1. Si String1 est égal à String2, , StrComp retourne 0. Si String1 est trié après String2, , StrComp retourne 1.

Notes

Pour plus d'informations, consultez la rubrique Visual Basic StrComp, fonction (Visual Basic).

Les chaînes sont comparées en fonction de valeurs de tri alphanumérique en commençant par le premier caractère. Pour plus d'informations sur les comparaisons binaires, les comparaisons textuelles et l'ordre de tri, consultez Option Compare, instruction.

L'argument Compare peut prendre les valeurs suivantes :

Constante	Description
Binary	Effectue une comparaison binaire en fonction d'un ordre de tri dérivé des représentations binaires internes des caractères.
Text	Effectue une comparaison textuelle en fonction d'un ordre de tri de texte qui ne respecte pas la casse, déterminé par la valeur LocaleID de votre système.

Exemple

Cet exemple utilise la fonction StrComp pour retourner les résultats d'une comparaison de chaînes. Si le troisième argument est omis, le type de comparaison effectué est celui qui est défini dans l'instruction Option Compare ou dans les valeurs par défaut du projet.

' Defines variables.
Dim TestStr1 As String = "ABCD"
Dim TestStr2 As String = "abcd"
Dim TestComp As Integer
' The two strings sort equally. Returns 0.
TestComp = StrComp(TestStr1, TestStr2, CompareMethod.Text)
' TestStr1 sorts after TestStr2. Returns -1.
TestComp = StrComp(TestStr1, TestStr2, CompareMethod.Binary)
' TestStr2 sorts before TestStr1. Returns 1.
TestComp = StrComp(TestStr2, TestStr1)

Plates-formes

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

Informations de version

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0

Voir aussi

Référence

Strings, classe
Membres Strings
Microsoft.VisualBasic, espace de noms
ArgumentException

Autres ressources

StrComp, fonction (Visual Basic)
Liste des manipulations de chaînes
Chaînes en Visual Basic
Introduction aux chaînes dans Visual Basic
InStr, fonction (Visual Basic)

Partager via