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

CKTIS / Java

`Matcher.matches()`: comprobar toda la región en Java

`Matcher.matches()` comprueba si una expresión regular coincide con toda la región actual, no solo con un fragmento. Por defecto, la región abarca toda la entrada.

Versión: Java SE 21

Sintaxis

public boolean matches()

Matcher.matches() es un método de instancia sin argumentos de java.util.regex.Matcher. Compila la expresión regular con Pattern.compile(regex), crea un Matcher con pattern.matcher(input) y llama a matcher.matches(). El método devuelve true solo si el patrón coincide con toda la región actual; en caso contrario, devuelve false.

Por defecto, la región abarca toda la entrada. Usa region(start, end) para fijar sus límites: start es inclusivo y end es exclusivo. Una vez fijados, matches() exige que coincida toda la región seleccionada, no toda la entrada original. No necesitas añadir ^ y $ solo para exigir una coincidencia con toda la región.

Usa lookingAt() si basta con una coincidencia al principio de la región o find() para buscar el siguiente fragmento que coincida dentro de ella. Si matches() devuelve true, group() devuelve el texto coincidente, y start() y end() dan sus índices de inicio inclusivo y fin exclusivo en la entrada. Después de false, esos tres métodos lanzan IllegalStateException si los llamas antes de obtener otra coincidencia.

Ejemplos

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

public class Main {
    public static void main(String[] args) {
        Pattern fourDigits = Pattern.compile("[0-9]{4}");
        String input = "id=1234!";

        System.out.println(fourDigits.matcher(input).matches());
        System.out.println(fourDigits.matcher(input).find());
        System.out.println(fourDigits.matcher("1234!").lookingAt());

        Matcher selected = fourDigits.matcher(input).region(3, 7);
        boolean matched = selected.matches();
        System.out.println(matched);
        if (matched) {
            System.out.println(selected.group());
        }
    }
}

Resultado

false
true
true
true
1234

El patrón `[0-9]{4}` exige exactamente cuatro dígitos ASCII. La cadena `id=1234!` no coincide en su totalidad, pero `find()` encuentra `1234`. En `1234!`, `lookingAt()` encuentra la coincidencia al principio. La región `[3, 7)` de `id=1234!` solo contiene `1234`, por lo que `matches()` devuelve `true` y `group()` devuelve `1234`.

Lecciones relacionadas

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

Fuentes