Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

List.indexOf(Object) — index prvního výskytu

Najděte první výskyt prvku v seznamu v Javě. Výsledkem je index počítaný od nuly, nebo `-1`, pokud se prvek v seznamu nenajde.

Verze: Java SE 21

Syntaxe

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

List.indexOf(Object) je metoda rozhraní java.util.List<E>, která jako argument přijímá hledaný objekt, nikoli index. Seznam nemění. Vrací nejmenší vyhovující index jako int: první prvek má index 0, a pokud se shoda nenajde, výsledkem je -1.

Na pozici i je shoda, pokud Objects.equals(o, list.get(i)) vrátí true. Dva argumenty null se považují za shodné; pokud o není null, použije se jeho metoda equals. Reference tedy nemusejí odkazovat na stejný objekt. Pokud seznam nepovoluje null, hledání null může vrátit -1 nebo vyvolat výjimku NullPointerException. Při nekompatibilním typu argumentu může implementace vrátit -1 nebo vyvolat výjimku ClassCastException.

Než výsledek předáte metodě get, ověřte index >= 0: -1 není platný index. Pokud jsou v seznamu duplicity a hledáte poslední výskyt, použijte lastIndexOf(Object). Pokud jen zjišťujete, zda je prvek přítomen, použijte contains(Object), která vrací boolean.

V mnoha implementacích je hledání lineární a může vyžadovat kontrolu všech prvků seznamu.

Příklady

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

Výsledek

0
2
-1
red

`new String("red")` záměrně vytvoří samostatný objekt se stejným textem. První a poslední shoda jsou na indexech `0` a `2`; pro `"green"` je výsledkem `-1`. Podmínka chrání volání `get`, jehož výsledek se vypíše jako `red`.

Související lekce

  • Java · Lekce 54 · Základní · Verze: 2

Zdroje