Class CharMatcher

java.lang.Object
cloud.opencode.base.string.builder.CharMatcher
public abstract class CharMatcher extends Object
Character Matcher (Guava Style) 字符匹配器（Guava风格）

Represents a set of characters for matching, removing, retaining, or replacing operations.

表示用于匹配、移除、保留或替换操作的字符集合。

Features | 主要功能:

  • Predefined character sets - 预定义字符集
  • Custom character matching - 自定义字符匹配
  • Boolean operations (and, or, negate) - 布尔运算
  • String transformation operations - 字符串转换操作

Usage Examples | 使用示例:

// Remove whitespace
String result = CharMatcher.whitespace().removeFrom("a b c"); // "abc"

// Retain only digits
String digits = CharMatcher.digit().retainFrom("abc123"); // "123"

// Replace characters
String replaced = CharMatcher.is('a').replaceFrom("banana", '*'); // "b*n*n*"

// Collapse consecutive whitespace
String collapsed = CharMatcher.whitespace().collapseFrom("a   b", ' '); // "a b"

Performance | 性能:

  • Time complexity: O(n) for most operations - 大多数操作时间复杂度: O(n)
  • Thread-safe: Yes (immutable) - 线程安全: 是（不可变）
Since:
JDK 25, opencode-base-string V1.0.0
Author:
Leon Soo www.LeonSoo.com
See Also: