Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

List.indexOf(Object) — índice de la primera coincidencia

Encuentra la primera aparición de un elemento en una lista de Java. El resultado es un índice que empieza en cero o `-1` si no hay coincidencias.

Versión: Java SE 21

Sintaxis

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

List.indexOf(Object) es un método de la interfaz java.util.List<E> que recibe el objeto que se busca, no un índice. No modifica la lista. Devuelve el menor índice que coincide como int: el primer elemento está en el índice 0 y, si no hay coincidencias, el resultado es -1.

La posición i coincide si Objects.equals(o, list.get(i)) devuelve true. Dos argumentos null se consideran iguales; si o no es null, se usa su método equals. Por tanto, las referencias no tienen que apuntar al mismo objeto. Si la lista no admite null, buscar null puede devolver -1 o lanzar NullPointerException. Si el tipo del argumento es incompatible, la implementación puede devolver -1 o lanzar ClassCastException.

Comprueba index >= 0 antes de pasar el resultado a get: -1 no es un índice válido. Si hay duplicados y quieres la última coincidencia, usa lastIndexOf(Object). Si solo necesitas saber si el elemento está presente, usa contains(Object), que devuelve un boolean.

En muchas implementaciones, la búsqueda es lineal y puede tener que examinar todos los elementos de la lista.

Ejemplos

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

Resultado

0
2
-1
red

`new String("red")` crea deliberadamente un objeto distinto con el mismo texto. La primera y la última coincidencia están en `0` y `2`; `"green"` da `-1`. La condición protege la llamada a `get`, cuyo resultado impreso es `red`.

Lecciones relacionadas

  • Java · Lección 54 · Básico · Versión: 2

Fuentes