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 です。