Java : Pattern (正規表現) - API使用例
更新日：2023年04月08日 公開日：2021年07月29日
Pattern (Java SE 18 & JDK 18) の使用例まとめです。
だいたいのメソッドを網羅済みです。
API仕様のおともにどうぞ。
概要
コンパイル済みの正規表現です。
Patternクラスは、コンパイルされた正規表現を表します。
同じ正規表現を何度も使う場合、コンパイル済みのPatternクラスを再利用することでパフォーマンスがよくなります。
// 完全一致の確認
final var pattern = Pattern.compile("a+bc");
final var matchPredicate = pattern.asMatchPredicate();
System.out.println(matchPredicate.test("abc")); // true
System.out.println(matchPredicate.test("aaaabc")); // true
System.out.println(matchPredicate.test("ab")); // false
System.out.println(matchPredicate.test("abcD")); // false
System.out.println(matchPredicate.test("Zabc")); // false
// 部分一致の確認
final var pattern = Pattern.compile("a+bc");
final var predicate = pattern.asPredicate();
System.out.println(predicate.test("abc")); // true
System.out.println(predicate.test("aaaabc")); // true
System.out.println(predicate.test("ab")); // false
System.out.println(predicate.test("abcD")); // true
System.out.println(predicate.test("Zabc")); // true
// Matcherで一致した文字列を取得する例。
final var pattern = Pattern.compile("a+bc");
final var matcher = pattern.matcher("xyz aaaabc 012");
// 一致した文字列を取得します。
if (matcher.find()) {
System.out.println(matcher.group()); // "aaaabc"
}
関連記事：正規表現の基本
フィールド
static final int CANON_EQ
正規等価を有効にします。
...
たとえば、このフラグを指定すると、表現「a\u030A」は文字列「\u00E5」にマッチします。
final var regex = "a\u030A";
System.out.println(regex); // å
final var input = "\u00E5";
System.out.println(input); // å
{
final var pattern = Pattern.compile(regex, Pattern.CANON_EQ);
final var matchPredicate = pattern.asMatchPredicate();
System.out.println(matchPredicate.test(input)); // true
}
{
final var pattern = Pattern.compile(regex);
final var matchPredicate = pattern.asMatchPredicate();
System.out.println(matchPredicate.test(input)); // false
}
static final int CASE_INSENSITIVE
大文字と小文字を区別しないマッチングを有効にします。
final var regex = "abc";
final var input = "ABC";
{
final var pattern = Pattern.compile(regex, Pattern.CASE_INSENSITIVE);
final var matchPredicate = pattern.asMatchPredicate();
System.out.println(matchPredicate.test(input)); // true
}
{
final var pattern = Pattern.compile(regex);
final var matchPredicate = pattern.asMatchPredicate();
System.out.println(matchPredicate.test(input)); // false
}
static final int COMMENTS
パターン内で空白とコメントを使用できるようにします。
final var regex = "a b c # xyz";
final var input = "abc";
{
final var pattern = Pattern.compile(regex, Pattern.COMMENTS);
final var matchPredicate = pattern.asMatchPredicate();
System.out.println(matchPredicate.test(input)); // true
}
{
final var pattern = Pattern.compile(regex);
final var matchPredicate = pattern.asMatchPredicate();
System.out.println(matchPredicate.test(input)); // false
}
static final int DOTALL
DOTALLモードを有効にします。
final var regex = "abc..yz";
final var input = "abc\nxyz";
{
final var pattern = Pattern.compile(regex, Pattern.DOTALL);
final var matchPredicate = pattern.asMatchPredicate();
System.out.println(matchPredicate.test(input)); // true
}
{
final var pattern = Pattern.compile(regex);
final var matchPredicate = pattern.asMatchPredicate();
System.out.println(matchPredicate.test(input)); // false
}
static final int LITERAL
パターンのリテラル構文解析を有効にします。
final var regex = "abc+";
final var input1 = "abc+";
final var input2 = "abccc";
{
final var pattern = Pattern.compile(regex, Pattern.LITERAL);
final var matchPredicate = pattern.asMatchPredicate();
System.out.println(matchPredicate.test(input1)); // true
System.out.println(matchPredicate.test(input2)); // false
}
{
final var pattern = Pattern.compile(regex);
final var matchPredicate = pattern.asMatchPredicate();
System.out.println(matchPredicate.test(input1)); // false
System.out.println(matchPredicate.test(input2)); // true
}
static final int MULTILINE
複数行モードを有効にします。
final var regex = "^abc$";
final var input1 = """
012
abc
xyz
""";
final var input2 = "abc";
{
final var pattern = Pattern.compile(regex, Pattern.MULTILINE);
final var predicate = pattern.asPredicate(); // 部分一致
System.out.println(predicate.test(input1)); // true
System.out.println(predicate.test(input2)); // true
}
{
final var pattern = Pattern.compile(regex);
final var predicate = pattern.asPredicate();
System.out.println(predicate.test(input1)); // false
System.out.println(predicate.test(input2)); // true
}
static final int UNICODE_CASE
Unicodeに準拠した大文字と小文字を区別しないマッチングを有効にします。
// 全角文字です。
final var regex = "ａｂｃ";
final var input = "ＡＢＣ";
{
final var pattern = Pattern.compile(regex, Pattern.UNICODE_CASE | Pattern.CASE_INSENSITIVE);
final var matchPredicate = pattern.asMatchPredicate();
System.out.println(matchPredicate.test(input)); // true
}
{
final var pattern = Pattern.compile(regex, Pattern.CASE_INSENSITIVE);
final var matchPredicate = pattern.asMatchPredicate();
System.out.println(matchPredicate.test(input)); // false
}
static final int UNICODE_CHARACTER_CLASS
定義済みの文字クラスとPOSIX文字クラスのUnicodeバージョンを使用可能にします。
final var regex = "\\p{Lower}+";
// 半角文字です。
final var input1 = "abc";
// 全角文字です。
final var input2 = "ａｂｃ";
{
final var pattern = Pattern.compile(regex, Pattern.UNICODE_CHARACTER_CLASS);
final var matchPredicate = pattern.asMatchPredicate();
System.out.println(matchPredicate.test(input1)); // true
System.out.println(matchPredicate.test(input2)); // true
}
{
final var pattern = Pattern.compile(regex);
final var matchPredicate = pattern.asMatchPredicate();
System.out.println(matchPredicate.test(input1)); // true
System.out.println(matchPredicate.test(input2)); // false
}
static final int UNIX_LINES
Unixライン・モードを有効にします。
final var regex = "^abc$";
final var input1 = "abc\r\nxyz";
final var input2 = "abc\nxyz";
final var input3 = "abc\rxyz";
{
final var pattern = Pattern.compile(regex, Pattern.UNIX_LINES | Pattern.MULTILINE);
final var predicate = pattern.asPredicate();
System.out.println(predicate.test(input1)); // false
System.out.println(predicate.test(input2)); // true
System.out.println(predicate.test(input3)); // false
}
{
final var pattern = Pattern.compile(regex, Pattern.MULTILINE);
final var predicate = pattern.asPredicate();
System.out.println(predicate.test(input1)); // true
System.out.println(predicate.test(input2)); // true
System.out.println(predicate.test(input3)); // true
}
メソッド
Predicate<String> asMatchPredicate ()
このパターンが指定された入力文字列と一致するかどうかをテストする述語を作成します。
final var pattern = Pattern.compile("a+bc");
final var matchPredicate = pattern.asMatchPredicate();
final var predicate = pattern.asPredicate();
System.out.println(matchPredicate.test("aaabc")); // true
System.out.println(predicate.test("aaabc")); // true
System.out.println(matchPredicate.test("012 abc xyz")); // false
System.out.println(predicate.test("012 abc xyz")); // true
Predicate<String> asPredicate ()
指定された入力文字列でこのパターンが検出されたかどうかをテストする述語を作成します。
このメソッドの使用例は、asMatchPredicate() にまとめて記載しました。
そちらのAPI使用例をご参照ください。
static Pattern compile (String regex)
指定された正規表現をパターンにコンパイルします。
final var pattern = Pattern.compile("a+bc");
final var matchPredicate = pattern.asMatchPredicate();
System.out.println(matchPredicate.test("abc")); // true
System.out.println(matchPredicate.test("aaaabc")); // true
System.out.println(matchPredicate.test("bc")); // false
static Pattern compile (String regex, int flags)
指定されたフラグを使用して、指定された正規表現をパターンにコンパイルします。
// 大文字小文字を区別しません。
final var pattern = Pattern.compile("abc", Pattern.CASE_INSENSITIVE);
final var matchPredicate = pattern.asMatchPredicate();
System.out.println(matchPredicate.test("abc")); // true
System.out.println(matchPredicate.test("ABC")); // true
// フラグなしの例です。
final var pattern = Pattern.compile("abc");
final var matchPredicate = pattern.asMatchPredicate();
System.out.println(matchPredicate.test("abc")); // true
System.out.println(matchPredicate.test("ABC")); // false
int flags ()
このパターンのマッチ・フラグを返します。
final var pattern = Pattern.compile("abc", Pattern.LITERAL);
System.out.println("0x%x".formatted(Pattern.LITERAL)); // 0x10
System.out.println("0x%x".formatted(pattern.flags())); // 0x10
final var pattern = Pattern.compile("abc", Pattern.UNICODE_CASE | Pattern.CASE_INSENSITIVE);
System.out.println("0x%x".formatted(Pattern.UNICODE_CASE)); // 0x40
System.out.println("0x%x".formatted(Pattern.CASE_INSENSITIVE)); // 0x2
System.out.println("0x%x".formatted(pattern.flags())); // 0x42
Matcher matcher (CharSequence input)
指定された入力とこのパターンをマッチする正規表現エンジンを作成します。
final var pattern = Pattern.compile("a+bc");
final var matcher = pattern.matcher("zyz aaaabc 012");
// 一致した文字列を取得します。
if (matcher.find()) {
System.out.println(matcher.group()); // "aaaabc"
}
static boolean matches (String regex, CharSequence input)
指定された正規表現をコンパイルして、指定された入力とその正規表現をマッチします。
System.out.println(Pattern.matches("a+bc", "aaabc")); // true
System.out.println(Pattern.matches("a+bc", "aaabc xyz")); // false
System.out.println(Pattern.matches("[a-z]+", "abcxyz")); // true
System.out.println(Pattern.matches("[a-z]+", "0123")); // false
String pattern ()
このパターンのコンパイル元の正規表現を返します。
final var pattern = Pattern.compile("a+bc");
System.out.println(pattern.pattern()); // "a+bc"
final var pattern = Pattern.compile("[a-z]+");
System.out.println(pattern.pattern()); // "[a-z]+"
static String quote (String s)
指定されたStringのリテラル・パターンStringを返します。
final var regex = "a+bc";
final var quote = Pattern.quote(regex);
System.out.println(quote); // "\Qa+bc\E"
final var pattern = Pattern.compile(quote);
final var matchPredicate = pattern.asMatchPredicate();
System.out.println(matchPredicate.test("a+bc")); // true
System.out.println(matchPredicate.test("aaabc")); // false
String[] split (CharSequence input)
このパターンのマッチに基づいて、指定された入力シーケンスを分割します。
final var input = "boo:and:foo";
final var pattern = Pattern.compile(":");
final var ret = pattern.split(input);
System.out.println(Arrays.toString(ret)); // [boo, and, foo]
final var input = "boo:and:foo";
final var pattern = Pattern.compile("o");
final var ret = pattern.split(input);
System.out.println(Arrays.toString(ret)); // [b, , :and:f]
String[] split (CharSequence input, int limit)
このパターンのマッチに基づいて、指定された入力シーケンスを分割します。
final var input = "boo:and:foo";
final var pattern = Pattern.compile(":");
final var ret1 = pattern.split(input, 2);
System.out.println(Arrays.toString(ret1)); // [boo, and:foo]
final var ret2 = pattern.split(input, 5);
System.out.println(Arrays.toString(ret2)); // [boo, and, foo]
final var ret3 = pattern.split(input, -2);
System.out.println(Arrays.toString(ret3)); // [boo, and, foo]
final var input = "boo:and:foo";
final var pattern = Pattern.compile("o");
final var ret1 = pattern.split(input, 5);
System.out.println(Arrays.toString(ret1)); // [b, , :and:f, , ]
final var ret2 = pattern.split(input, -2);
System.out.println(Arrays.toString(ret2)); // [b, , :and:f, , ]
final var ret3 = pattern.split(input, 0);
System.out.println(Arrays.toString(ret3)); // [b, , :and:f]
Stream<String> splitAsStream (CharSequence input)
このパターンのマッチに基づいて、指定された入力シーケンスからストリームを作成します。
final var input = "boo:and:foo";
final var pattern = Pattern.compile(":");
final var stream = pattern.splitAsStream(input);
stream.forEach(s -> {
System.out.println(s);
});
// 結果
// ↓
// "boo"
// "and"
// "foo"
final var input = "boo:and:foo";
final var pattern = Pattern.compile("o");
final var stream = pattern.splitAsStream(input);
stream.forEach(s -> {
System.out.println(s);
});
// 結果
// ↓
// "b"
// ""
// ":and:f"
String toString ()
このパターンの文字列表現を返します。
final var pattern = Pattern.compile("a+bc");
final var str = pattern.toString();
System.out.println(str); // "a+bc"
final var pattern = Pattern.compile("[a-z]+");
final var str = pattern.toString();
System.out.println(str); // "[a-z]+"
関連記事
- API 使用例