CKTIS / Java
List.contains(Object) — verificar se uma lista contém um elemento
Verifica se a lista contém um elemento igual ao valor procurado antes de adicionares o nome de uma tarefa ou de a marcares como concluída.
Versão: Java SE 21
Sintaxe
boolean contains(Object o)
boolean present = list.contains(value);List.contains(Object) é um método de java.util.List. A chamada list.contains(o) devolve true se houver um elemento e para o qual Objects.equals(o, e) seja true, e false se não houver correspondência. O método não devolve um índice nem altera a lista.
Para haver correspondência, as referências não têm de apontar para o mesmo objeto. String.equals compara a sequência de caracteres completa e distingue maiúsculas de minúsculas: "Review" corresponde a outro objeto String com o mesmo texto, mas não a "review" nem à subcadeia "Rev".
O parâmetro é do tipo Object, não E, mesmo numa List<String>. Se o tipo do argumento for incompatível, a implementação pode devolver false ou lançar ClassCastException. Se a lista aceitar null, contains(null) só devolve true quando a lista contém null. Se não o aceitar, a chamada pode devolver false ou lançar NullPointerException.
Em código executado numa única thread, usa !tasks.contains(name) antes de adicionares um nome a uma lista modificável para evitar duplicados. Usa tasks.contains(name) para confirmar que o nome existe antes de uma operação separada marcar a tarefa como concluída.
Exemplos
import java.util.ArrayList;
import java.util.List;
public class Main {
public static void main(String[] args) {
List<String> tasks = new ArrayList<>();
tasks.add("Review");
String candidate = new String("Review");
System.out.println(tasks.contains(candidate));
System.out.println(tasks.contains("review"));
if (!tasks.contains(candidate)) {
tasks.add(candidate);
}
System.out.println(tasks.size());
}
}Resultado
true false 1
`candidate` é um objeto distinto com o mesmo texto que o elemento guardado, pelo que o primeiro resultado é `true`. Trocar a inicial por uma minúscula dá `false`. A condição impede a adição do duplicado e o tamanho mantém-se em `1`.
Lições relacionadas
- Java · Lição 22 · Intermédio · Versão: 2