Compartilhar via


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

Definição

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);
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

Um dos seguintes valores:

IfStrComp retorna
String1 classifica à frente de String2-1
String1 é igual a String20
String1 classifica após String21

Exceções

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.

Aplica-se a

Confira também