Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes