CKTIS / Java
String.matches: comprobar si una cadena completa coincide con una expresión regular
Comprueba la coincidencia de toda la cadena. Aprende cómo `(?s)` cambia el comportamiento del punto, qué clases usan ASCII de forma predeterminada y cómo escribir las barras inversas en literales de Java.
Versión: Java SE 21
Sintaxis
public boolean matches(String regex)String.matches es un método de instancia de java.lang.String. La llamada text.matches(regex) interpreta el argumento como una expresión regular y devuelve true solo si coincide todo text, no solo una subcadena. No hacen falta las anclas ^ y $. Para buscar una subcadena que coincida, usa Pattern.compile(regex).matcher(text).find().
Coloca (?s) al principio del patrón para activar DOTALL: así . también coincide con los caracteres de fin de línea, que no acepta de forma predeterminada. No confundas (?s) con (?m): MULTILINE cambia el comportamiento de las anclas ^ y $, no el del punto.
En una expresión regular, [A-Z] es el intervalo de letras mayúsculas ASCII de A a Z. De forma predeterminada, \d equivale a [0-9] y \w a [a-zA-Z_0-9]. La opción (?U) (UNICODE_CHARACTER_CLASS) activa las variantes Unicode de estas clases predefinidas, pero no amplía el intervalo explícito [A-Z].
Los literales de cadena de Java y las expresiones regulares se interpretan por separado. Escribe "\\d" para pasar \d al motor y "\\." para pasar \. y hacer coincidir un punto literal. Un patrón no válido lanza PatternSyntaxException y un argumento null lanza NullPointerException; en ninguno de los casos se devuelve false. Si reutilizas el mismo patrón, compílalo una vez con Pattern.compile(regex) y llama a pattern.matcher(text).matches() para cada cadena.
Ejemplos
import java.util.regex.Pattern;
public class Main {
public static void main(String[] args) {
String code = "[A-Z]{2}\\.\\d{2}";
String withPrefix = "XAB.42";
String nonAsciiDigits = "AB.\u0664\u0662";
String twoLines = "start\nend";
System.out.println("whole: " + "AB.42".matches(code));
System.out.println("prefixed whole: " + withPrefix.matches(code));
System.out.println("prefixed find: " + Pattern.compile(code).matcher(withPrefix).find());
System.out.println("wrong separator: " + "AB-42".matches(code));
System.out.println("default digits: " + nonAsciiDigits.matches(code));
System.out.println("Unicode digits: " + nonAsciiDigits.matches("(?U)" + code));
System.out.println("default dot: " + twoLines.matches("start.*end"));
System.out.println("DOTALL dot: " + twoLines.matches("(?s)start.*end"));
}
}Resultado
whole: true prefixed whole: false prefixed find: true wrong separator: false default digits: false Unicode digits: true default dot: false DOTALL dot: true
`AB.42` coincide por completo, mientras que `find()` encuentra una subcadena coincidente en `XAB.42`. El guion no sustituye al punto literal. Los dígitos arábigo-índicos solo coinciden con `(?U)`, y el punto solo coincide con el salto de línea con `(?s)`.
Lecciones relacionadas
- Java · Lección 1 · Intermedio · Versión: 2