Matcher クラス

署名

public Integer end()

戻り値

型: Integer

署名

public Integer end(Integer groupIndex)

パラメータ

groupIndex

型: Integer

戻り値

型: Integer

使用方法

取得されたグループは、左から右へ、1 から順にインデックス付けされます。グループ 0 はパターン全体を表します。つまり、 m.end(0) は m.end() と同じ意味となります。

「キャプチャグループについて」を参照してください。

署名

public Boolean find()

戻り値

型: Boolean

使用方法

このメソッドは Matcher オブジェクトのリージョンの最初から開始します。または、前のメソッド呼び出しが成功し、Matcher オブジェクトがそれ以降リセットされていない場合、前のマッチ処理で一致しなかった最初の文字から開始します。

マッチ処理が成功した場合、start、end、group メソッドを使用してさらに多くの情報を取得できます。

詳細は、「リージョンの使用」を参照してください。

署名

public Boolean find(Integer group)

パラメータ

group

型: Integer

戻り値

型: Boolean

使用方法

マッチ処理が成功した場合、start、end、group メソッドを使用してさらに多くの情報を取得できます。

署名

public String group()

戻り値

型: String

使用方法

(a*) など、グループによっては空の文字列にも一致します。入力された空の文字列とそのようなグループが一致した場合、このメソッドは空の文字列を返します。

署名

public String group(Integer groupIndex)

パラメータ

groupIndex

型: Integer

戻り値

型: String

使用方法

取得されたグループは、左から右へ、1 から順にインデックス付けされます。グループ 0 はパターン全体を表します。つまり、m.group(0) は m.group() と同じ意味となります。

(a*) など、グループによっては空の文字列にも一致します。入力された空の文字列とそのようなグループが一致した場合、このメソッドは空の文字列を返します。

「キャプチャグループについて」を参照してください。

署名

public Integer groupCount()

戻り値

型: Integer

使用方法

「キャプチャグループについて」を参照してください。

署名

public Boolean hasAnchoringBounds()

戻り値

型: Boolean

使用方法

Matcher オブジェクトがアンカー付き境界を使用している場合、Matcher オブジェクトのリージョンの境界は ^ や $ などのラインアンカー行の開始と終了に一致します。

詳細は、「境界の使用」を参照してください。

署名

public Boolean hasTransparentBounds()

戻り値

型: Boolean

使用方法

詳細は、「境界の使用」を参照してください。

署名

public Boolean hitEnd()

戻り値

型: Boolean

署名

public Boolean lookingAt()

戻り値

型: Boolean

使用方法

matches メソッドと同様に、このメソッドは必ずリージョンの先頭から開始します。異なる点は、リージョン全体が一致する必要がないことです。

マッチ処理が成功した場合、start、end、group メソッドを使用してさらに多くの情報を取得できます。

「リージョンの使用」を参照してください。

署名

public Boolean matches()

戻り値

型: Boolean

使用方法

マッチ処理が成功した場合、start、end、group メソッドを使用してさらに多くの情報を取得できます。

「リージョンの使用」を参照してください。

署名

public Pattern object pattern()

戻り値

型: System.Pattern

署名

public static String quoteReplacement(String inputString)

パラメータ

inputString

型: String

戻り値

型: String

使用方法

入力文字列の $ や ^ などのメタキャラクタやエスケープシーケンスは、特に意味のないリテラル文字として扱われます。

署名

public Matcher object region(Integer start, Integer end)

パラメータ

start

型: Integer

end

型: Integer

戻り値

型: Matcher

使用方法

このメソッドは最初に Matcher オブジェクトをリセットし、start で指定されたインデックスで開始し、end で指定されたインデックスで終了するよう設定します。

使用されている透明な境界により、アンカーのような特定の構造が。リージョンの境界またはその周りで異なる動作をする可能性があります。

「リージョンの使用」および「境界の使用」を参照してください。

署名

public Integer regionEnd()

戻り値

型: Integer

使用方法

「リージョンの使用」を参照してください。

署名

public Integer regionStart()

戻り値

型: Integer

使用方法

「リージョンの使用」を参照してください。

署名

public String replaceAll(String replacementString)

パラメータ

replacementString

型: String

戻り値

型: String

使用方法

このメソッドは最初に Matcher オブジェクトをリセットし、パターンの一致を探しながら入力シーケンスをスキャンします。一致のどの部分にも含まれない文字は、結果の文字列に直接追加されます。各一致は、置き換え文字列により結果の文字列が置き換えられます。置き換え文字列には、取得されたサブシーケンスへの参照が含まれている場合があります。

置き換え文字列のバックスラッシュ (\) とドル記号 ($) は、文字列がリテラル置き換え文字列として処理された場合は異なる結果となる場合があります。ドル記号は取得されたサブシーケンスへの参照、バックスラッシュは置き換え文字列の中でリテラル文字をエスケープするために使用されます。

このメソッドを起動すると、Matcher オブジェクトの状態が変わります。Matcher オブジェクトをさらにマッチ処理で使用する場合、まずリセットする必要があります。

正規表現 a*b、入力文字列 "aabfooaabfooabfoob"、置き換え文字列 "-" を指定する場合、その表現の Matcher オブジェクトでこのメソッドを呼び出すと、文字列 "-foo-foo-foo-" が生成されます。

署名

public String replaceFirst(String replacementString)

パラメータ

replacementString

型: String

戻り値

型: String

使用方法

置き換え文字列のバックスラッシュ (\) とドル記号 ($) は、文字列がリテラル置き換え文字列として処理された場合は異なる結果となる場合があります。ドル記号は取得されたサブシーケンスへの参照、バックスラッシュは置き換え文字列の中でリテラル文字をエスケープするために使用されます。

このメソッドを起動すると、Matcher オブジェクトの状態が変わります。Matcher オブジェクトをさらにマッチ処理で使用する場合、まずリセットする必要があります。

正規表現 dog、入力文字列 "zzzdogzzzdogzzz"、置き換え文字列 "cat" を指定する場合、その表現の Matcher オブジェクトでこのメソッドを呼び出すと、文字列 "zzzcatzzzdogzzz" が生成されます。

署名

public Boolean requireEnd()

戻り値

型: Boolean

使用方法

このメソッドが true を返し、かつ一致が見つかった場合、入力が増えると一致しなくなる場合があります。

このメソッドが false を返し、かつ一致が見つかった場合、入力が増えると一致結果が変わる場合がありますが、一致しなくなることはありません。

一致が見つからなかった場合、requireEnd は意味を持ちません。

署名

public Matcher object reset()

戻り値

型: Matcher

使用方法

Matcher オブジェクトがアンカー付き境界を使用しているかどうかに関わらず、メソッドは変わりません。アンカー付き境界を変更するには、useAnchoringBounds メソッドを明示的に使用する必要があります。

詳細は、「境界の使用」を参照してください。

署名

public Matcher reset(String inputSequence)

パラメータ

inputSequence

型: String

戻り値

型: Matcher

署名

public Integer start()

戻り値

型: Integer

署名

public Integer start(Integer groupIndex)

パラメータ

groupIndex

型: Integer

戻り値

型: Integer

使用方法

「キャプチャグループについて」を参照してください。

署名

public Matcher object useAnchoringBounds(Boolean anchoringBounds)

パラメータ

anchoringBounds

型: Boolean

true を指定すると、Matcher オブジェクトはアンカー付き境界を使用します。false を指定すると、非アンカー付き境界を使用します。

戻り値

型: Matcher

使用方法

Matcher オブジェクトがアンカー付き境界を使用している場合、Matcher オブジェクトのリージョンの境界は ^ や $ などのラインアンカー行の開始と終了に一致します。

詳細は、「境界の使用」を参照してください。

署名

public Matcher object usePattern(Pattern pattern)

パラメータ

pattern

型: System.Pattern

戻り値

型: Matcher

署名

public Matcher object useTransparentBounds(Boolean transparentBounds)

パラメータ

transparentBounds

型: Boolean

true を指定すると、Matcher オブジェクトは透明な境界を使用します。false を指定すると、不透明な境界を使用します。

戻り値

型: Matcher

使用方法

詳細は、「境界の使用」を参照してください。