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

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

Fuentes