Class Multiset<T>
java.lang.Object
com.sure.tool.collection.Multiset<T>
- Type Parameters:
T- 元素类型
计数集合(Multiset):记录每个元素出现的次数,对标 Guava
Multiset 与
commons-collections4 Bag 的常用子集,零依赖。
典型场景:词频统计、元素频次统计、投票计数。size() 返回含重复的总数,
uniqueSize() 返回去重元素数。
线程安全:本类非线程安全;并发场景需外部同步。
- Since:
- 1.10.0
-
Nested Class Summary
Nested Classes -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescription添加一个元素,计数 +1。批量添加元素,计数 +occurrences。voidclear()清空所有元素与计数。int指定元素出现次数。去重元素集合(视图)。entrySet()元素与计数条目集合。booleanisEmpty()是否为空。iterator()迭代器:按计数展开元素(如 a x2、b x1 → a、a、b)。boolean移除一个元素,计数 -1(计数归零时删除元素)。int批量移除元素。设置元素计数(0 表示移除该元素)。intsize()含重复计数的总元素数。toString()int去重元素数。
-
Constructor Details
-
Multiset
public Multiset()
-
-
Method Details
-
add
-
add
批量添加元素,计数 +occurrences。- Parameters:
element- 元素occurrences- 次数(必须为正数)- Returns:
- 本对象,支持链式调用
- Throws:
IllegalArgumentException- occurrences 非正
-
remove
-
remove
批量移除元素。- Parameters:
element- 元素occurrences- 次数- Returns:
- 实际移除次数(受已有计数限制)
-
setCount
设置元素计数(0 表示移除该元素)。- Parameters:
element- 元素count- 新计数(≥0)- Returns:
- 本对象,支持链式调用
- Throws:
IllegalArgumentException- count 为负
-
count
-
elementSet
-
entrySet
-
size
public int size()含重复计数的总元素数。- Returns:
- 总数
-
uniqueSize
public int uniqueSize()去重元素数。- Returns:
- 去重数
-
iterator
-
isEmpty
public boolean isEmpty()是否为空。- Returns:
- 是否为空
-
clear
public void clear()清空所有元素与计数。 -
toString
-