Comparar cadeias de caracteres no .NET

O .NET fornece vários métodos para comparar os valores de cadeias de caracteres. A tabela a seguir lista e descreve os métodos de comparação de valores.

Método Compare

O método estático String.Compare fornece uma maneira completa de comparar duas cadeias de caracteres. Esse método é cultural. Você pode usar essa função para comparar duas cadeias de caracteres ou subcadeias de duas cadeias de caracteres. Além disso, sobrecargas são fornecidas para considerar ou ignorar a variação cultural ou de caso. A tabela a seguir mostra os três valores inteiros que esse método pode retornar.

O exemplo a seguir usa o método String.Compare para determinar os valores relativos das duas cadeias de caracteres.

String^ string1 = "Hello World!";
Console::WriteLine(String::Compare(string1, "Hello World?"));

string string1 = "Hello World!";
Console.WriteLine(String.Compare(string1, "Hello World?"));

Dim string1 As String = "Hello World!"
Console.WriteLine(String.Compare(string1, "Hello World?"))

Este exemplo exibe -1 no console.

O exemplo anterior diferencia a cultura por padrão. Para realizar uma comparação de cadeia de caracteres que não diferencia a cultura, use uma sobrecarga do método String.Compare que permite que você especifique a cultura a ser usada, fornecendo um parâmetro culture. Confira um exemplo que demonstra como usar o método String.Compare para realizar uma comparação de cadeia de caracteres que não fazem distinção entre culturas em Comparações de cadeias de caracteres que não fazem distinção entre culturas.

Método CompareOrdinal

O método String.CompareOrdinal compara dois objetos de cadeia de caracteres sem considerar a cultura local. Os valores de retorno desse método são idênticos aos valores retornados pelo método Compare na tabela anterior.

O exemplo a seguir usa o método CompareOrdinal para comparar os valores de duas cadeias de caracteres.

String^ string1 = "Hello World!";
Console::WriteLine(String::CompareOrdinal(string1, "hello world!"));

string string1 = "Hello World!";
Console.WriteLine(String.CompareOrdinal(string1, "hello world!"));

Dim string1 As String = "Hello World!"
Console.WriteLine(String.CompareOrdinal(string1, "hello world!"))

Este exemplo exibe -32 no console.

Método CompareTo

O método String.CompareTo compara a cadeia de caracteres que o objeto atual de cadeia de caracteres encapsula com outro objeto ou cadeia de caracteres. Os valores de retorno desse método são idênticos aos valores retornados pelo método String.Compare na tabela anterior.

O exemplo a seguir usa o método String.CompareTo para comparar o objeto string1 ao objeto string2.

String^ string1 = "Hello World";
String^ string2 = "Hello World!";
int MyInt = string1->CompareTo(string2);
Console::WriteLine( MyInt );

string string1 = "Hello World";
string string2 = "Hello World!";
int MyInt = string1.CompareTo(string2);
Console.WriteLine( MyInt );

Dim string1 As String = "Hello World"
Dim string2 As String = "Hello World!"
Dim MyInt As Integer = string1.CompareTo(string2)
Console.WriteLine(MyInt)

Este exemplo exibe -1 no console.

Todas as sobrecargas do método String.CompareTo executam comparações que diferenciam a cultura e com diferenciação de maiúsculas e minúsculas por padrão. Nenhuma sobrecarga desse método é fornecida que permite que você execute uma comparação sem diferenciação de cultura. Em vez disso, para ter maior clareza do código, é recomendável usar o método String.Compare, especificando CultureInfo.CurrentCulture para operações que fazem distinção entre culturas ou CultureInfo.InvariantCulture para operações que não fazem distinção entre culturas. Confira exemplos que demonstram como usar o método String.Compare para realizar comparações de cadeia de caracteres que fazem e não fazem distinção entre culturas em Executar comparações de cadeias de caracteres que não fazem distinção entre culturas.

Método Equals

O método String.Equals pode facilmente determinar se duas cadeias de caracteres são as mesmas. Esse método que diferencia maiúsculas de minúsculas retorna um valor Booliano true ou false. Ele pode ser usado de uma classe existente, conforme ilustrado no exemplo a seguir. O exemplo a seguir usa o método Equals para determinar se um objeto de cadeia de caracteres contém a frase "Hello World".

String^ string1 = "Hello World";
Console::WriteLine(string1->Equals("Hello World"));

string string1 = "Hello World";
Console.WriteLine(string1.Equals("Hello World"));

Dim string1 As String = "Hello World"
Console.WriteLine(string1.Equals("Hello World"))

Este exemplo exibe True no console.

Esse método também pode ser usado como um método estático. O exemplo a seguir compara dois objetos de cadeia de caracteres usando um método estático.

String^ string1 = "Hello World";
String^ string2 = "Hello World";
Console::WriteLine(String::Equals(string1, string2));

string string1 = "Hello World";
string string2 = "Hello World";
Console.WriteLine(String.Equals(string1, string2));

Dim string1 As String = "Hello World"
Dim string2 As String = "Hello World"
Console.WriteLine(String.Equals(string1, string2))

Este exemplo exibe True no console.

Métodos StartsWith e EndsWith

Você pode usar o método String.StartsWith para determinar se um objeto de cadeia de caracteres começa com os mesmos caracteres que englobam outra cadeia de caracteres. Esse método que diferencia maiúsculas de minúsculas retorna true se o objeto atual de cadeia de caracteres começa com a cadeia de caracteres passada e false se não existir. O exemplo a seguir usa esse método para determinar se um objeto de cadeia de caracteres começa com "Hello".

String^ string1 = "Hello World";
Console::WriteLine(string1->StartsWith("Hello"));

string string1 = "Hello World";
Console.WriteLine(string1.StartsWith("Hello"));

Dim string1 As String = "Hello World!"
Console.WriteLine(string1.StartsWith("Hello"))

Este exemplo exibe True no console.

O método String.EndsWith compara uma cadeia de caracteres passada com os caracteres que existem no final do objeto de cadeia de caracteres atual. Ele também retorna um valor Booliano. O exemplo a seguir verifica o fim de uma cadeia de caracteres usando o método EndsWith.

String^ string1 = "Hello World";
Console::WriteLine(string1->EndsWith("Hello"));

string string1 = "Hello World";
Console.WriteLine(string1.EndsWith("Hello"));

Dim string1 As String = "Hello World!"
Console.WriteLine(string1.EndsWith("Hello"))

Este exemplo exibe False no console.

Métodos IndexOf e LastIndexOf

É possível o método String.IndexOf para determinar a posição da primeira ocorrência de um determinado caractere dentro de uma cadeia de caracteres. Esse método que diferencia maiúsculas de minúsculas inicia a contagem do início de uma cadeia de caracteres e retorna a posição de um caractere passado usando um índice baseado em zero. Se o caractere não for encontrado, um valor de -1 será retornado.

O exemplo a seguir usa o método IndexOf para pesquisar a primeira ocorrência do caractere 'l' em uma cadeia de caracteres.

String^ string1 = "Hello World";
Console::WriteLine(string1->IndexOf('l'));

string string1 = "Hello World";
Console.WriteLine(string1.IndexOf('l'));

Dim string1 As String = "Hello World!"
Console.WriteLine(string1.IndexOf("l"))

Este exemplo exibe 2 no console.

O método String.LastIndexOf é semelhante ao método String.IndexOf, exceto que ele retorna a posição da última ocorrência de um determinado caractere dentro de uma cadeia de caracteres. Ele diferencia maiúsculas de minúsculas e usa um índice baseado em zero.

O exemplo a seguir usa o método LastIndexOf para pesquisar a última ocorrência do caractere 'l' em uma cadeia de caracteres.

String^ string1 = "Hello World";
Console::WriteLine(string1->LastIndexOf('l'));

string string1 = "Hello World";
Console.WriteLine(string1.LastIndexOf('l'));

Dim string1 As String = "Hello World!"
Console.WriteLine(string1.LastIndexOf("l"))

Este exemplo exibe 9 no console.

Ambos os métodos são úteis quando usados em conjunto com o método String.Remove. Você pode usar tanto o método IndexOf quanto o LastIndexOf para recuperar a posição de um caractere e, em seguida, fornecer essa posição para o método Remove para remover um caractere ou uma palavra que comece com esse caractere.

Confira também

• Práticas recomendadas para o uso de cadeias de caracteres no .NET
• Operações básicas de cadeias de caracteres
• Executar operações de cadeia de caracteres que não levam em conta a cultura
• Classificar tabelas de peso – usado pelo .NET Framework e .NET Core 1.0-3.1 no Windows
• Tabela de elementos de ordenação Unicode padrão – usada pelo .NET 5 em todas as plataformas e pelo .NET Core no Linux e no macOS