JavaのCharMatcherクラスとは？主要メソッドと使い方を徹底解説

CharMatcherクラスは、Predicateが任意のObjectに対して真偽値を判定するのと同じように、任意のJavaのchar値に対してtrueまたはfalseを判定するクラスです。Google Guavaライブラリに含まれており、文字単位のマッチングやフィルタリング処理をシンプルかつ直感的に記述できる強力なユーティリティとして知られています。

CharMatcherの主なメソッド

サンプルコード

それでは、お好みのエディタを使用して、例えば「C:/>Guava」フォルダに以下のJavaプログラムを作成してみましょう。

以下はGuavaTester.javaのコードです。

import com.google.common.base.CharMatcher;
import com.google.common.base.Splitter;

public class GuavaTester {

    public static void main(String args[]) {
        GuavaTester tester = new GuavaTester();
        tester.testCharMatcher();
    }

    private void testCharMatcher() {
        // 数字のみを抽出する
        System.out.println(CharMatcher.DIGIT.retainFrom("mahesh123"));

        // 前後の空白を取り除き、内部の連続する空白を1つのスペースにまとめる
        System.out.println(CharMatcher.WHITESPACE.trimAndCollapseFrom(" Mahesh Parashar ", ' '));

        // すべての数字を「*」に置き換える
        System.out.println(CharMatcher.JAVA_DIGIT.replaceFrom("mahesh123", "*"));

        // 数字または小文字以外の文字を除外する
        System.out.println(CharMatcher.JAVA_DIGIT.or(CharMatcher.JAVA_LOWER_CASE).retainFrom("mahesh123"));
    }
}

続いて、javacコンパイラを使ってクラスをコンパイルします。

C:\Guava>javac GuavaTester.java

コンパイルが完了したら、GuavaTesterを実行して結果を確認しましょう。

C:\Guava>java GuavaTester

実行結果

このプログラムを実行すると、以下のような出力が得られます。

123
Mahesh Parashar
mahesh***
mahesh123

出力内容の解説

• 123：retainFrom()により、「mahesh123」から数字のみが抽出されました。
• Mahesh Parashar：trimAndCollapseFrom()により、前後の空白が除去され、連続する空白が1つのスペースにまとめられました。
• mahesh***：replaceFrom()により、すべての数字が「*」に置き換えられました。
• mahesh123：or()で組み合わせたマッチャーにより、数字と小文字以外の文字が除外されました。

なお、Guavaの比較的新しいバージョンでは、DIGITやJAVA_DIGITといった定数はdigit()やjavaDigit()などの静的ファクトリメソッドへと置き換えられている点に注意してください。