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

CKTIS / Java

Matcher.find: buscar coincidencias sucesivas

Usa `find()` para buscar coincidencias sucesivas de una expresión regular o `find(int start)` para reiniciar la búsqueda desde un índice concreto de la entrada.

Versión: Java SE 21

Sintaxis

public boolean find()
public boolean find(int start)

Matcher.find es un método de instancia de java.util.regex.Matcher. Crea un Matcher con pattern.matcher(input). Si el objeto es nuevo o se ha reiniciado, find() empieza al principio de la región, que de forma predeterminada abarca toda la entrada. Reutiliza el mismo objeto en while (matcher.find()): tras una coincidencia no vacía, la siguiente búsqueda empieza justo después de ella. true indica que se encontró una coincidencia, aunque sea vacía; false indica que no se encontró otra.

Tras obtener true, usa group() para leer el texto completo de la coincidencia, start() para su inicio incluido y end() para su final excluido. Los índices empiezan en cero y se refieren a toda la entrada. Lee el resultado antes de realizar otro intento: la API especifica IllegalStateException para estos métodos antes del primer intento o después de uno fallido.

find(int start) reinicia el Matcher, restablece la región a toda la entrada y busca a partir de start. No exige que la coincidencia empiece exactamente en ese índice. Lanza IndexOutOfBoundsException si start es negativo o mayor que la longitud de la entrada. Para continuar la búsqueda, llama a find() sin argumentos; find(int start) la reinicia en cada llamada.

lookingAt() exige que la coincidencia empiece al principio de la región, pero no que la abarque por completo. matches() exige que coincida toda la región. find() busca en cualquier posición de la región que permita el patrón.

Ejemplos

import java.util.regex.Matcher;
import java.util.regex.Pattern;

public class Main {
    public static void main(String[] args) {
        Matcher matcher = Pattern.compile("[0-9]+").matcher("A12 B7");

        while (matcher.find()) {
            System.out.println(matcher.group() + " [" + matcher.start()
                    + ", " + matcher.end() + ")");
        }

        if (matcher.find(4)) {
            System.out.println("find(4): " + matcher.group());
        }
    }
}

Resultado

12 [1, 3)
7 [5, 6)
find(4): 7

`[0-9]+` coincide con secuencias de uno o más dígitos ASCII. El bucle imprime `12` y `7` con sus intervalos. Después del bucle, `find(4)` empieza en `B` y encuentra `7` en el índice `5`.

Lecciones relacionadas

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

Fuentes