Instrução Option Compare

Artigo
06/08/2023

Declara o método padrão de comparação a ser usado ao comparar dados da cadeia de caracteres.

Sintaxe

Option Compare { Binary | Text }

Partes

Termo Definição

Binary Opcional. Resulta em comparações de cadeias de caracteres com base em uma ordem de classificação derivada das representações binárias internas dos caracteres.

Esse tipo de comparação é útil principalmente se as cadeias de caracteres puderem conter caracteres que não serão interpretados como texto. Nesse caso, você não deseja ajustar comparações com equivalentes em ordem alfabética, como maiúsculas e minúsculas.

Text Opcional. Resulta em comparações de cadeias de caracteres com base em uma ordem de classificação de texto com diferenciação de maiúsculas de minúsculas determinada pela localidade do sistema.

Esse tipo de comparação é útil se suas cadeias de caracteres tiverem todos os caracteres de texto e você desejar compará-las levando em conta equivalências alfabéticas como maiúsculas e minúsculas e letras relacionadas. Por exemplo, você pode desejar considerar que A e a sejam iguais, e que Ä e ä venham antes de B e b.

Termo	Definição
`Binary`	Opcional. Resulta em comparações de cadeias de caracteres com base em uma ordem de classificação derivada das representações binárias internas dos caracteres. Esse tipo de comparação é útil principalmente se as cadeias de caracteres puderem conter caracteres que não serão interpretados como texto. Nesse caso, você não deseja ajustar comparações com equivalentes em ordem alfabética, como maiúsculas e minúsculas.
`Text`	Opcional. Resulta em comparações de cadeias de caracteres com base em uma ordem de classificação de texto com diferenciação de maiúsculas de minúsculas determinada pela localidade do sistema. Esse tipo de comparação é útil se suas cadeias de caracteres tiverem todos os caracteres de texto e você desejar compará-las levando em conta equivalências alfabéticas como maiúsculas e minúsculas e letras relacionadas. Por exemplo, você pode desejar considerar que `A` e `a` sejam iguais, e que `Ä` e `ä` venham antes de `B` e `b`.

Comentários

Se usado, a instrução Option Compare deve aparecer em um arquivo antes de quaisquer outras instruções de código-fonte.

A instrução Option Compare especifica o método de comparação de cadeia de caracteres (Binary ou Text). O método de comparação de texto padrão é Binary.

A comparação Binary compara o valor de Unicode numérico de cada caractere em cadeia de caracteres. A comparação Text compara cada caractere Unicode com base em seu sentido lexical na cultura atual.

No Microsoft Windows, a ordem de classificação é determinada pela página de código. Para obter mais informações, consulte Páginas de Código.

No exemplo a seguir, os caracteres na página de código Inglês/Europeu (ANSI 1252) são classificados usando Option Compare Binary, que produz uma ordem de classificação binária típica.

A < B < E < Z < a < b < e < z < À < Ê < Ø < à < ê < ø

Quando os mesmos caracteres na mesma página de código são classificados usando Option Compare Text, a ordem de classificação a seguir é produzida.

(A=a) < (À = à) < (B=b) < (E=e) < (Ê = ê) < (Z=z) < (Ø = ø)

Quando uma Instrução Option Compare Não Está Presente

Se o código-fonte não contiver uma instrução Option Compare, será usada a configuração de Option Compare em Compilar Página, Designer de Projeto (Visual Basic). Se você usar o compilador de linha de comando, a configuração especificada pela opção do compilador -optioncompare é usada.

Observação

Seu computador pode mostrar diferentes nomes ou locais para alguns dos elementos de interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos. Para obter mais informações, consulte Personalizando o IDE.

Para definir o Option Compare no IDE

No Gerenciador de Soluções, selecione um projeto. No menu Projeto , clique em Propriedades.
Clique na guia Compilar.
Defina o valor na caixa Option Compare.

Ao criar um novo projeto, a configuração Option Compare na guia Compilar é definida para a configuração Option Compare na caixa de diálogo Opções. Para alterar essa configuração, no menu Ferramentas, clique em Opções. Na caixa de diálogo Opções, expanda Projetos e Soluções e, em seguida, clique em Padrões de VB. A configuração inicial padrão nos Padrões de VB é Binária.

Para definir o Option Compare na linha de comando

Inclua a opção -optioncompare do compilador no comando vbc.

Exemplo 1

O exemplo a seguir usa a instrução Option Compare para definir a comparação binária como o método padrão de comparação de cadeia de caracteres. Para usar esse código, retire os comentários da instrução Option Compare Binary e coloque-os na parte superior do arquivo de origem.

' Option Compare Binary

Console.WriteLine("A" < "a")
' Output: True

Exemplo 2

O exemplo a seguir usa a instrução Option Compare para definir a ordem de classificação sem diferenciação de maiúsculas de minúsculas como o método padrão de comparação de cadeia de caracteres. Para usar esse código, retire os comentários da instrução Option Compare Text e coloque-os na parte superior do arquivo de origem.

' Option Compare Text

Console.WriteLine("A" = "a")
' Output: True

Compartilhar via