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

CKTIS / Java

Matcher — comprobar texto y leer coincidencias

java.util.regex.Matcher aplica una expresión regular al texto. matches() comprueba toda la región, find() busca subcadenas sucesivas y group() lee el resultado de una coincidencia correcta.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

Pattern pattern = Pattern.compile(regex);
Matcher matcher = pattern.matcher(input);
boolean whole = matcher.matches();
matcher.reset();
while (matcher.find()) {
    String match = matcher.group();
    // groupCount() counts capturing groups in the pattern, excluding group 0.
    // This guard checks that group 1 exists, not that it participated in the match.
    if (matcher.groupCount() >= 1) {
        String captured = matcher.group(1);
    }
}

java.util.regex.Matcher compara un Pattern con el texto. Créalo con pattern.matcher(input). El objeto conserva el estado de búsqueda; no lo compartas entre varios hilos.

Matcher.matches() comprueba toda la región actual, que de forma predeterminada abarca toda la entrada. Matcher.find() busca la siguiente subcadena coincidente; las llamadas sucesivas hacen avanzar la búsqueda. Ambos métodos devuelven boolean. reset() descarta el estado de coincidencia y restablece la región para que abarque toda la entrada.

Matcher.group() y group(0) devuelven la coincidencia completa. Los grupos de captura se numeran desde 1 según el orden de los paréntesis de apertura: group(1) lee el primero. Lee un grupo con nombre mediante group("name"). Un grupo opcional que no haya participado devuelve null, mientras que un grupo que coincida con texto vacío devuelve "".

Lee los grupos después de obtener true: antes de intentar una coincidencia o después de un intento fallido, group() lanza una IllegalStateException. En el ejemplo, matches() devuelve false porque el patrón no abarca toda la entrada. Después de reset(), el bucle find() lee dos coincidencias y sus grupos.

Ejemplos

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

public class Main {
    public static void main(String[] args) {
        Pattern pattern = Pattern.compile("([A-Z]+)-([0-9]+)");
        Matcher matcher = pattern.matcher("AB-12 CD-7");

        System.out.println("matches=" + matcher.matches());
        matcher.reset();
        while (matcher.find()) {
            System.out.println(matcher.group() + " | "
                    + matcher.group(1) + " | " + matcher.group(2));
        }
    }
}

Resultado

matches=false
AB-12 | AB | 12
CD-7 | CD | 7

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes