CKTIS / Java
String.equalsIgnoreCase — comparação sem distinguir maiúsculas de minúsculas
String.equalsIgnoreCase compara cadeias de caracteres sem distinguir maiúsculas de minúsculas, independentemente das definições regionais. Devolve um boolean.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
public boolean equalsIgnoreCase(String anotherString)String.equalsIgnoreCase exige que as cadeias tenham o mesmo comprimento e que os pontos de código Unicode correspondentes coincidam. Os pontos coincidem se forem idênticos ou se Character.toLowerCase(Character.toUpperCase(int)) produzir o mesmo resultado.
Um argumento null resulta em false; invocar o método num recetor null lança uma NullPointerException. Ao contrário deste método, equals distingue maiúsculas de minúsculas.
O método não tem em conta as definições regionais; para comparações dependentes da língua, utilize Collator. Não considera ß equivalente a SS: os comprimentos são diferentes.
Exemplos
public class Main {
public static void main(String[] args) {
System.out.println("Java".equalsIgnoreCase("jAvA"));
System.out.println("Java".equals("jAvA"));
System.out.println("Java".equalsIgnoreCase(null));
System.out.println("ß".equalsIgnoreCase("SS"));
}
}Resultado
true false false false
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.