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

CKTIS / Java

Pattern.matcher — Crear un Matcher para una entrada

`Pattern.matcher` crea un nuevo `Matcher` para la entrada indicada. Puedes reutilizar un patrón compilado con varios textos y mantener separado el estado de cada búsqueda.

Versión: Java SE 21

Sintaxis

public Matcher matcher(CharSequence input)

Pattern pattern = Pattern.compile(regex);
Matcher matcher = pattern.matcher(input);

Pattern.matcher(CharSequence input) es un método de instancia de Pattern, del paquete java.util.regex. Primero compila la expresión regular con Pattern.compile(regex) y después llama a pattern.matcher(input) sobre el patrón obtenido. El argumento, por ejemplo un String, es el texto que quieres examinar, no la expresión regular. Pasar null lanza NullPointerException.

Cada llamada devuelve un nuevo Matcher sin intentar aún ninguna coincidencia. find() busca la siguiente subcadena que coincide, lookingAt() intenta encontrar una coincidencia desde el inicio de la región y matches() comprueba la región completa. Por defecto, la región abarca toda la entrada. Los tres métodos devuelven un boolean.

Tras una coincidencia, group() devuelve la subcadena coincidente completa. Llamar a group() antes del primer intento o después de un intento fallido lanza IllegalStateException. En un bucle, llama a group() solo si find() devuelve true.

Un Pattern es inmutable y se puede compartir entre hilos. Un Matcher mantiene un estado mutable y no es seguro para uso concurrente. Crea objetos Matcher distintos cuando necesites estados independientes. reset() conserva la entrada y reset(newInput) la cambia; ambos descartan el resultado anterior y vuelven a establecer la región en toda la entrada.

Ejemplos

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

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

        while (scan.find()) {
            System.out.println(scan.group());
        }
        System.out.println(whole.matches());
    }
}

Resultado

12
34
true

`[0-9]+` coincide con uno o más dígitos ASCII consecutivos. El primer `Matcher` imprime `12` y `34`. El segundo usa el mismo patrón e imprime `true` porque toda su entrada, `56`, coincide.

Lecciones relacionadas

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

Fuentes