CKTIS / Java
Pattern.matcher — Criar um Matcher para uma entrada
`Pattern.matcher` cria um novo `Matcher` para a entrada indicada. O mesmo padrão compilado pode ser reutilizado em vários textos, mantendo separado o estado de cada pesquisa.
Versão: Java SE 21
Sintaxe
public Matcher matcher(CharSequence input)
Pattern pattern = Pattern.compile(regex);
Matcher matcher = pattern.matcher(input);Pattern.matcher(CharSequence input) é um método de instância de Pattern, no pacote java.util.regex. Primeiro, compila a expressão regular com Pattern.compile(regex) e depois chama pattern.matcher(input) no padrão obtido. O argumento, por exemplo um String, é o texto a analisar, não a expressão regular. Passar null lança uma NullPointerException.
Cada chamada devolve um novo Matcher sem ainda tentar encontrar uma correspondência. find() procura a próxima subcadeia que corresponde ao padrão, lookingAt() tenta encontrar uma correspondência a partir do início da região e matches() verifica a região inteira. Por omissão, a região abrange toda a entrada. Os três métodos devolvem um boolean.
Após uma correspondência bem-sucedida, group() devolve a subcadeia correspondente na íntegra. Uma chamada antes da primeira tentativa ou após uma tentativa falhada lança uma IllegalStateException. Num ciclo, chama group() apenas quando find() devolver true.
Um Pattern é imutável e pode ser partilhado entre threads. Um Matcher mantém estado mutável e não é seguro para utilização concorrente. Cria objetos Matcher distintos quando precisares de estados independentes. reset() mantém a entrada e reset(newInput) substitui-a; ambos descartam o resultado anterior e voltam a definir a região como a totalidade da entrada.
Exemplos
import java.util.regex.Matcher;
import java.util.regex.Pattern;
public class Main {
public static void main(String[] args) {
Pattern digits = Pattern.compile("[0-9]+");
Matcher scan = digits.matcher("A12 B34");
Matcher whole = digits.matcher("56");
while (scan.find()) {
System.out.println(scan.group());
}
System.out.println(whole.matches());
}
}Resultado
12 34 true
`[0-9]+` corresponde a um ou mais algarismos ASCII consecutivos. O primeiro `Matcher` escreve `12` e `34`. O segundo usa o mesmo padrão e escreve `true` porque toda a sua entrada, `56`, corresponde ao padrão.
Lições relacionadas
- Java · Lição 70 · Básico · Versão: 2