CKTIS / Java
List.indexOf(Object) — index van de eerste overeenkomst
Vind de eerste plek waar een element in een Java-lijst voorkomt. De index begint bij nul; als niets overeenkomt, is het resultaat `-1`.
Versie: Java SE 21
Syntax
int indexOf(Object o)
int index = list.indexOf(value);List.indexOf(Object) is een methode van java.util.List<E> die het te zoeken object als argument krijgt, niet een index. De lijst blijft ongewijzigd. De methode geeft de laagste passende index terug als int: het eerste element staat op index 0 en zonder overeenkomst krijg je -1.
Positie i komt overeen als Objects.equals(o, list.get(i)) true oplevert. Twee null-argumenten zijn gelijk; als o niet null is, wordt zijn methode equals gebruikt. De referenties hoeven dus niet naar hetzelfde object te wijzen. Als de lijst geen null toestaat, kan zoeken naar null -1 opleveren of een NullPointerException veroorzaken. Bij een incompatibel argumenttype kan de implementatie -1 teruggeven of een ClassCastException veroorzaken.
Controleer index >= 0 voordat je het resultaat aan get doorgeeft: -1 is geen geldige index. Gebruik bij duplicaten lastIndexOf(Object) als je de laatste overeenkomst zoekt. Wil je alleen weten of het element aanwezig is, gebruik dan contains(Object), dat een boolean teruggeeft.
In veel implementaties is de zoekactie lineair en moeten mogelijk alle elementen van de lijst worden bekeken.
Voorbeelden
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));
}
}
}Resultaat
0 2 -1 red
`new String("red")` maakt bewust een afzonderlijk object met dezelfde tekst. De eerste en laatste overeenkomst staan op `0` en `2`; `"green"` geeft `-1`. De voorwaarde bewaakt de aanroep van `get`, waarvan het resultaat wordt afgedrukt als `red`.
Gerelateerde lessen
- Java · Les 54 · Basis · Versie: 2