CKTIS / Java
Matcher.group() y Matcher.group(int): coincidencia completa y grupos
Tras una coincidencia de la expresión regular, recupera todo el texto coincidente o lo capturado por un grupo concreto. El grupo 0 es la coincidencia completa.
Versión: Java SE 21
Sintaxis
public String group()
public String group(int group)En Java SE 21, java.util.regex.Matcher ofrece tres sobrecargas de group que devuelven un String. Aquí se describen group() y group(int); la tercera sobrecarga, group(String), devuelve el texto capturado por un grupo con nombre. Matcher.group() devuelve todo el fragmento de la entrada que coincidió y equivale a group(0). Con un índice de 1 a groupCount(), Matcher.group(int) devuelve el texto capturado por el grupo seleccionado. Los grupos de captura se numeran de izquierda a derecha según sus paréntesis de apertura. Un grupo sin captura (?:...) no recibe número y groupCount() no incluye el grupo 0.
Lee los grupos después de que matches(), find() o lookingAt() devuelva true. matches() comprueba toda la región actual de la entrada, find() busca el siguiente fragmento que coincida y lookingAt() comprueba si hay una coincidencia al inicio de la región sin exigir que la cubra por completo. Los métodos group no realizan la búsqueda. Lee los valores que necesites antes de otro intento o de llamar a reset().
Si hay una coincidencia, pero el grupo seleccionado no participó, group(int) devuelve null. Si el grupo participó y coincidió con cero caracteres, devuelve la cadena vacía "". Antes del primer intento, tras un intento fallido o tras reset() sin un nuevo intento, ambas sobrecargas lanzan IllegalStateException. Con un estado de coincidencia válido, un índice fuera de rango provoca IndexOutOfBoundsException. Cambiar el patrón con usePattern(...) tras una coincidencia descarta los datos de los grupos; antes de otro intento, ambas sobrecargas pueden devolver null.
Ejemplos
import java.util.regex.Matcher;
import java.util.regex.Pattern;
public class Main {
public static void main(String[] args) {
Pattern pattern = Pattern.compile("(ID)-([0-9]+)([A-Z])?([ ]*)");
Matcher matcher = pattern.matcher("item: ID-42");
if (matcher.find()) {
System.out.println("group() = [" + matcher.group() + "]");
System.out.println("group(0) = [" + matcher.group(0) + "]");
System.out.println("group(1) = [" + matcher.group(1) + "]");
System.out.println("group(2) = [" + matcher.group(2) + "]");
System.out.println("group(3) = " + matcher.group(3));
System.out.println("group(4) = [" + matcher.group(4) + "]");
}
}
}Resultado
group() = [ID-42] group(0) = [ID-42] group(1) = [ID] group(2) = [42] group(3) = null group(4) = []
`find()` encuentra `ID-42` en `item: ID-42`. El grupo 3 no participa porque falta la letra opcional. El grupo 4 coincide con cero espacios, por lo que `[]` muestra una cadena vacía.
Lecciones relacionadas
- Java · Lección 70 · Básico · Versión: 2