API version 1
- ‐

RegexPattern

正規表現パターンを保持するクラスです。

compile スタティックメソッドにより、指定した正規表現をコンパイルし、RegexPatternオブジェクトを生成します。 生成したRegexPatternオブジェクトは、任意の入力文字列とのマッチを行うための正規表現エンジンである RegexMatcher クラスのオブジェクトを生成するために使用します。

1つのRegexPatternオブジェクトからは複数のRegexMatcherオブジェクトを生成できます。それぞれのRegexMatcherオブジェクトは同じ正規表現パターンを共有します。

デフォルトプロパティ

デフォルトプロパティは pattern です。

典型的な利用方法

  1. compile スタティックメソッドにより、正規表現をコンパイルし、RegexPatternオブジェクトを生成します。
  2. 1で生成したRegexPatternオブジェクトの matcher メソッドにより、正規表現パターンと入力文字列のマッチを行うRegexMatcherオブジェクトを生成します。
  3. 2で生成したRegexMatcherオブジェクトの hasMatch プロパティ等でマッチを行います。

正規表現構文要約

正規表現の構文はPCRE2(PCRE - Perl Compatible Regular Expressions)を使用しています。

メタ文字


\ 直後のメタキャラクターをクォートします。
^ 行の先頭にマッチします。複数行モードでは行の始まり。
. 任意のキャラクター(改行を除く)にマッチします。
$ 行の終端にマッチします。複数行モードでは行の終わり。
| 選択
() グループ化
[] 文字クラス

文字クラスで使用可能なメタ文字


\ 直後のメタキャラクターをクォートします。
^ 最初の文字に用いた場合のみ、クラスを否定する。
- 文字の範囲

バイナリキャラクタ


\t タブ
\v 垂直タブ
\n 改行
\r リターン
\f 改ページ
\cletter 制御キャラクター
\0 null
\int 後方参照
\nhhhh 4進数キャラクター
\xhh 16進数キャラクター

一般キャラクタ


\w "単語"キャラクター(アルファベット、数字、"_")にマッチします
\W 単語キャラクターでないものにマッチします
\s 空白(whitespace)キャラクターにマッチします
\S 非空白キャラクターにマッチします
\d 数字にマッチします
\D 非数字にマッチします

位置指定子


\b 単語境界にマッチします
\B 単語境界以外にマッチします

キャラクタクラス[:class:]


alnum 英数字
alpha 英字
blank 空白またはタブ
cntrl 制御文字
digit 10進数字
d 10進数字
graph 表可能文字 スペースを除く
lower 小文字の英字
print 表示可能文字
punct 句読文字
space 空白文字
upper 大文字の英字
xdigit 16進数字
w "単語"キャラクター(アルファベット、数字、"_")
s 空白(whitespace)キャラクター

量指定子


* ゼロ回以上の繰り返しにマッチします
+ 一回以上の繰り返しにマッチします
? ゼロ回もしくは一回の繰り返しにマッチします
{n} n回の繰り返しにマッチします
{n,} 少なくともn回ある繰り返しにマッチします
{n,m} n回からm回の間の繰り返しにマッチします

デフォルトプロパティ

デフォルトプロパティは pattern です。