Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

List.indexOf(Object) — indeks pierwszego wystąpienia

Znajdź pierwsze wystąpienie elementu na liście w Javie. Wynik to indeks liczony od zera albo `-1`, jeśli elementu nie znaleziono.

Wersja: Java SE 21

Składnia

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

List.indexOf(Object) to metoda interfejsu java.util.List<E>, która przyjmuje szukany obiekt, a nie indeks. Nie zmienia listy. Zwraca najmniejszy pasujący indeks jako int: pierwszy element ma indeks 0, a brak dopasowania oznacza -1.

Pozycja i pasuje, jeśli Objects.equals(o, list.get(i)) zwraca true. Dwa argumenty null są równe; dla argumentu o różnego od null stosuje się jego equals. Dopasowanie nie wymaga więc, by obie referencje wskazywały ten sam obiekt. Jeśli lista nie dopuszcza null, wyszukanie null może zwrócić -1 albo zgłosić NullPointerException. Przy niezgodnym typie argumentu implementacja może zwrócić -1 albo zgłosić ClassCastException.

Przed przekazaniem wyniku do get sprawdź index >= 0: -1 nie jest poprawnym indeksem. Przy duplikatach użyj lastIndexOf(Object), jeśli chcesz znaleźć ostatnie wystąpienie. Jeśli interesuje Cię tylko obecność elementu, użyj contains(Object), które zwraca boolean.

W wielu implementacjach wyszukiwanie jest liniowe i może wymagać sprawdzenia wszystkich elementów listy.

Przykłady

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

Wynik

0
2
-1
red

`new String("red")` celowo tworzy osobny obiekt o tej samej treści. Pierwsze i ostatnie dopasowanie mają indeksy `0` i `2`; `"green"` daje `-1`. Warunek chroni wywołanie `get`, które wypisuje `red`.

Powiązane lekcje

  • Java · Lekcja 54 · Podstawowy · Wersja: 2

Źródła