KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

List.contains(Object) — controleren of een lijst een element bevat

Controleer of de lijst een element bevat dat gelijk is aan de gezochte waarde voordat je een taaknaam toevoegt of de taak als voltooid markeert.

Versie: Java SE 21

Syntax

boolean contains(Object o)

boolean present = list.contains(value);

List.contains(Object) is een methode van java.util.List. De aanroep list.contains(o) geeft true terug als er een element e is waarvoor Objects.equals(o, e) geldt, en false als er geen overeenkomst is. De methode geeft geen index terug en wijzigt de lijst niet.

De referenties hoeven niet naar hetzelfde object te wijzen. String.equals vergelijkt de volledige tekenreeks en maakt onderscheid tussen hoofdletters en kleine letters: "Review" komt overeen met een ander String-object met dezelfde tekst, maar niet met "review" of de deeltekenreeks "Rev".

Het parametertype is Object, niet E, ook bij een List<String>. Bij een incompatibel argumenttype kan de implementatie false teruggeven of een ClassCastException werpen. Staat de lijst null toe, dan geeft contains(null) alleen true terug als de lijst null bevat. Staat de lijst null niet toe, dan kan de aanroep false teruggeven of een NullPointerException werpen.

Gebruik in code die in één thread draait !tasks.contains(name) voordat je een naam aan een wijzigbare lijst toevoegt om een duplicaat te voorkomen. Gebruik tasks.contains(name) om te controleren of de naam bestaat voordat een aparte bewerking de taak als voltooid markeert.

Voorbeelden

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());
    }
}

Resultaat

true
false
1

`candidate` is een afzonderlijk object met dezelfde tekst als het opgeslagen element, dus het eerste resultaat is `true`. Een kleine beginletter levert `false` op. De voorwaarde voorkomt dat het duplicaat wordt toegevoegd, dus de lijst blijft `1` element groot.

Gerelateerde lessen

  • Java · Les 22 · Gemiddeld · Versie: 2

Bronnen