[API] java.util.regex.Matcherクラス

java.util.regex.Matcherは、パターンマッチングや検索を行うためのクラスです。

java.util.regex.Matcherの特徴

java.util.regex.Matcherは以下の特徴があります。

• Matcherオブジェクトは、Patternクラスの.matcherメソッドで取得します。
• Matcherオブジェクトに対して操作することで、マッチや置換などの操作が可能

java.util.regex.Matcherの継承・実装

継承クラス

・java.lang.Object
　・java.util.regex.Matcher

実装インターフェース

・java.util.regex.MatchResult

導入バージョン

・JDK1.4

java.util.regex.MatcherのAPI

java.util.regex.Matcherサンプル

（Matcherオブジェクトを生成する）

Pattern ptn = Pattern.compile("[0-9a-zA-Z]+");
Matcher mtc = ptn.matcher("ABC");

（正規表現にマッチした文字が含まれているか判定する）

Pattern ptn = Pattern.compile("[0-9a-zA-Z]+");
Matcher mtc = ptn.matcher("ABC");
boolean b = mtc.find();

⇒ true

（マッチした文字をすべて指定した文字で置換する）

Pattern ptn = Pattern.compile("[0-9a-zA-Z]+");
Matcher mtc = ptn.matcher("ABCあ123");
String str = mtc.replaceAll("X");

⇒XあX

（一番最初にマッチした文字のみ指定した文字で置換する）

Pattern ptn = Pattern.compile("[0-9a-zA-Z]+");
Matcher mtc = ptn.matcher("ABCあ123");
String str = mtc.replaceFirst("X");

⇒Xあ123

（マッチした箇所を順番に取得する）

Pattern ptn = Pattern.compile("[0-9a-zA-Z]+");
Matcher mtc = ptn.matcher("ABCあ123");
while (mtc.find()) {
  String str = mtc.group();
  System.out.print(str + ",");
}

⇒ ABC,123,

関連API

• [API] java.util.regex.Pattern