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

Referência

Definição

Namespace:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Origem:: Strings.vb

Origem:: Strings.vb

Origem:: Strings.vb

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

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.

Aplica-se a

Compartilhar via