Strings.StrComp(String, String, CompareMethod) Método

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Origem:

Strings.vb

Retorna -1, 0 ou 1, com base no resultado de uma comparação de cadeia de caracteres.

public static int StrComp (string? String1, string? String2, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);

static member StrComp : string * string * Microsoft.VisualBasic.CompareMethod -> int

Public Function StrComp (String1 As String, String2 As String, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As Integer

Parâmetros

String1

String

Obrigatórios. Qualquer expressão String válida.

String2

String

Obrigatórios. Qualquer expressão String válida.

Compare

CompareMethod

Opcional. Especifica o tipo de comparação de cadeias de caracteres. Se Compare for omitido, a configuração Option Compare determinará o tipo de comparação.

Retornos

Int32

Um dos seguintes valores:

If	StrComp retorna
String1 classifica à frente de String2	-1
String1 é igual a String2	0
String1 classifica após String2	1

Exceções

ArgumentException

O valor Compare não é válido.

Exemplos

Este exemplo usa a StrComp função para retornar os resultados de uma comparação de cadeia de caracteres.

' 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 before testStr2. Returns -1.
testComp = StrComp(testStr1, testStr2, CompareMethod.Binary)
' testStr2 sorts after testStr1. Returns 1.
testComp = StrComp(testStr2, testStr1, CompareMethod.Binary)

Comentários

As cadeias de caracteres são comparadas por valores de classificação alfanuméricos que começam com o primeiro caractere. Para obter mais informações sobre comparações binárias, comparações textuais e ordem de classificação, consulte Instrução Option Compare.

As configurações do argumento Compare são:

Constante	Descrição
Binary	Executa uma comparação binária, com base em uma ordem de classificação derivada das representações binárias internas dos caracteres.
Text	Executa uma comparação de texto, com base em uma ordem de classificação de texto que não diferencia maiúsculas de minúsculas determinada pelo valor do LocaleID sistema.

Confira também

• InStr
• ArgumentException
• Resumo de manipulação da cadeia de caracteres
• Cadeias de caracteres no Visual Basic
• Introdução a cadeias de caracteres no Visual Basic