CKTIS / Java
Pattern.compile — compilar uma expressão regular
Compile uma expressão regular num objeto `Pattern` e reutilize o mesmo padrão para verificar várias cadeias de entrada.
Versão: Java SE 21
Sintaxe
import java.util.regex.Pattern;
// Static method signatures in java.util.regex.Pattern:
public static Pattern compile(String regex)
public static Pattern compile(String regex, int flags)Em Java SE 21, Pattern.compile é um método estático da classe java.util.regex.Pattern. Recebe uma expressão regular sob a forma de String e devolve um objeto Pattern compilado. A compilação, por si só, não verifica nenhum texto de entrada.
Pattern.compile(regex) não recebe um argumento separado para as opções, mas a expressão pode conter uma opção incorporada, como (?i). A sobrecarga Pattern.compile(regex, flags) recebe uma máscara de bits do tipo int. Use | para combinar opções, por exemplo Pattern.CASE_INSENSITIVE | Pattern.UNICODE_CASE para ignorar diferenças entre maiúsculas e minúsculas segundo as regras Unicode.
Uma sintaxe inválida provoca a exceção não verificada PatternSyntaxException durante a compilação do padrão. A sobrecarga com opções lança IllegalArgumentException se a máscara tiver bits ativos que não correspondam a opções definidas.
pattern.matcher(input) cria um Matcher para a entrada indicada. O método matches() verifica toda a região atual, que, por predefinição, abrange a entrada completa. Para procurar uma subcadeia que corresponda ao padrão, use find(). Para várias verificações, reutilize o Pattern imutável, que pode ser partilhado entre threads. Um Matcher guarda o estado da pesquisa e não é seguro utilizá-lo de forma concorrente.
Exemplos
import java.util.regex.Pattern;
public class Main {
public static void main(String[] args) {
Pattern[] patterns = {
Pattern.compile("[A-Z]{2}[0-9]{2}"),
Pattern.compile("[0-9]+"),
Pattern.compile("[A-Z]+"),
Pattern.compile("[A-Z0-9]+"),
Pattern.compile("AB.*")
};
System.out.println("Pattern | AB12 | 123");
for (Pattern pattern : patterns) {
System.out.println(pattern.pattern() + " | "
+ pattern.matcher("AB12").matches() + " | "
+ pattern.matcher("123").matches());
}
}
}Resultado
Pattern | AB12 | 123
[A-Z]{2}[0-9]{2} | true | false
[0-9]+ | false | true
[A-Z]+ | false | false
[A-Z0-9]+ | true | true
AB.* | true | false
O programa compila cinco padrões sem opções e testa cada um com `AB12` e `123`. `[A-Z]+` não corresponde a `AB12`: as letras `AB` correspondem ao padrão, mas `matches()` exige que toda a entrada corresponda.
Lições relacionadas
- Java · Lição 70 · Básico · Versão: 2