База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

List.indexOf(Object) — индекс на първото съвпадение

Намери първото срещане на елемент в списък в Java. Резултатът е индекс, броен от нула, или `-1`, ако няма съвпадение.

Версия: Java SE 21

Синтаксис

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

List.indexOf(Object) е метод на интерфейса java.util.List<E>, който приема търсения обект, а не индекс. Той не променя списъка. Връща най-малкия индекс на съвпадение като int: първият елемент е с индекс 0, а при липса на съвпадение резултатът е -1.

На позиция i има съвпадение, ако Objects.equals(o, list.get(i)) върне true. Два аргумента null се смятат за равни; ако o не е null, се използва неговият метод equals. Следователно не е нужно референциите да сочат към един и същ обект. Ако списъкът не допуска null, търсенето на null може да върне -1 или да предизвика NullPointerException. При несъвместим тип на аргумента реализацията може да върне -1 или да предизвика ClassCastException.

Провери index >= 0, преди да подадеш резултата на get: -1 не е валиден индекс. При повторения използвай lastIndexOf(Object), ако ти трябва последното съвпадение. Ако искаш само да провериш дали елементът присъства, използвай contains(Object), който връща boolean.

В много реализации търсенето е линейно и може да се наложи да провери всички елементи на списъка.

Примери

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

Резултат

0
2
-1
red

`new String("red")` нарочно създава отделен обект със същия текст. Първото и последното съвпадение са на индекси `0` и `2`; за `"green"` резултатът е `-1`. Условието предпазва извикването на `get`, чийто резултат се отпечатва като `red`.

Свързани уроци

  • Java · Урок 54 · Начално · Версия: 2

Източници