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