Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes