WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

List.indexOf(Object) — Index des ersten Treffers

Finde das erste Vorkommen eines Elements in einer Java-Liste. Das Ergebnis ist ein nullbasierter Index oder `-1`, wenn kein Element passt.

Version: Java SE 21

Syntax

int indexOf(Object o)
int index = list.indexOf(value);

List.indexOf(Object) ist eine Methode der Schnittstelle java.util.List<E>. Sie erwartet das gesuchte Objekt, keinen Index, und verändert die Liste nicht. Sie liefert den kleinsten passenden Index als int: Das erste Element hat den Index 0, und ohne Treffer lautet das Ergebnis -1.

Position i passt, wenn Objects.equals(o, list.get(i)) den Wert true liefert. Zwei null-Argumente gelten als gleich; ist o nicht null, wird dessen Methode equals verwendet. Für einen Treffer müssen die Referenzen also nicht auf dasselbe Objekt zeigen. Erlaubt die Liste kein null, kann die Suche nach null entweder -1 liefern oder eine NullPointerException auslösen. Bei einem inkompatiblen Argumenttyp kann die Implementierung -1 liefern oder eine ClassCastException auslösen.

Prüfe index >= 0, bevor du das Ergebnis an get übergibst: -1 ist kein gültiger Index. Verwende bei Duplikaten lastIndexOf(Object), wenn du den letzten Treffer brauchst. Geht es nur darum, ob das Element vorhanden ist, verwende contains(Object), das einen boolean zurückgibt.

In vielen Implementierungen ist die Suche linear und muss unter Umständen alle Listenelemente prüfen.

Beispiele

import java.util.List;

public class Main {
    public static void main(String[] args) {
        List<String> colors = List.of("red", "blue", "red");
        String target = new String("red");
        int first = colors.indexOf(target);

        System.out.println(first);
        System.out.println(colors.lastIndexOf(target));
        System.out.println(colors.indexOf("green"));
        if (first >= 0) {
            System.out.println(colors.get(first));
        }
    }
}

Ergebnis

0
2
-1
red

`new String("red")` erzeugt absichtlich ein separates Objekt mit demselben Text. Der erste und letzte Treffer liegen bei `0` und `2`; `"green"` ergibt `-1`. Die Bedingung sichert den Aufruf von `get` ab, der zur Ausgabe `red` führt.

Zugehörige Lektionen

  • Java · Lektion 54 · Grundlagen · Version: 2

Quellen