Class Multiset<T>

java.lang.Object
com.sure.tool.collection.Multiset<T>
Type Parameters:
T - 元素类型

public class Multiset<T> extends Object
计数集合(Multiset):记录每个元素出现的次数,对标 Guava Multiset 与 commons-collections4 Bag 的常用子集,零依赖。

典型场景:词频统计、元素频次统计、投票计数。size() 返回含重复的总数, uniqueSize() 返回去重元素数。

线程安全:本类非线程安全;并发场景需外部同步。

Since:
1.10.0
  • Nested Class Summary

    Nested Classes
    Modifier and Type
    Class
    Description
    static final class 
    元素与计数条目。
  • Constructor Summary

    Constructors
    Constructor
    Description
     
  • Method Summary

    Modifier and Type
    Method
    Description
    add(T element)
    添加一个元素,计数 +1。
    add(T element, int occurrences)
    批量添加元素,计数 +occurrences。
    void
    清空所有元素与计数。
    int
    count(T element)
    指定元素出现次数。
    去重元素集合(视图)。
    元素与计数条目集合。
    boolean
    是否为空。
    迭代器:按计数展开元素(如 a x2、b x1 → a、a、b)。
    boolean
    remove(T element)
    移除一个元素,计数 -1(计数归零时删除元素)。
    int
    remove(T element, int occurrences)
    批量移除元素。
    setCount(T element, int count)
    设置元素计数(0 表示移除该元素)。
    int
    含重复计数的总元素数。
     
    int
    去重元素数。

    Methods inherited from class Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
  • Constructor Details

    • Multiset

      public Multiset()
  • Method Details

    • add

      public Multiset<T> add(T element)
      添加一个元素,计数 +1。
      Parameters:
      element - 元素(可为 null)
      Returns:
      本对象,支持链式调用
    • add

      public Multiset<T> add(T element, int occurrences)
      批量添加元素,计数 +occurrences。
      Parameters:
      element - 元素
      occurrences - 次数(必须为正数)
      Returns:
      本对象,支持链式调用
      Throws:
      IllegalArgumentException - occurrences 非正
    • remove

      public boolean remove(T element)
      移除一个元素,计数 -1(计数归零时删除元素)。
      Parameters:
      element - 元素
      Returns:
      是否发生移除
    • remove

      public int remove(T element, int occurrences)
      批量移除元素。
      Parameters:
      element - 元素
      occurrences - 次数
      Returns:
      实际移除次数(受已有计数限制)
    • setCount

      public Multiset<T> setCount(T element, int count)
      设置元素计数(0 表示移除该元素)。
      Parameters:
      element - 元素
      count - 新计数(≥0)
      Returns:
      本对象,支持链式调用
      Throws:
      IllegalArgumentException - count 为负
    • count

      public int count(T element)
      指定元素出现次数。
      Parameters:
      element - 元素
      Returns:
      次数(不存在为 0)
    • elementSet

      public Set<T> elementSet()
      去重元素集合(视图)。
      Returns:
      元素集合
    • entrySet

      public Set<Multiset.Entry<T>> entrySet()
      元素与计数条目集合。
      Returns:
      条目集合
    • size

      public int size()
      含重复计数的总元素数。
      Returns:
      总数
    • uniqueSize

      public int uniqueSize()
      去重元素数。
      Returns:
      去重数
    • iterator

      public Iterator<T> iterator()
      迭代器:按计数展开元素(如 a x2、b x1 → a、a、b)。
      Returns:
      展开迭代器
    • isEmpty

      public boolean isEmpty()
      是否为空。
      Returns:
      是否为空
    • clear

      public void clear()
      清空所有元素与计数。
    • toString

      public String toString()
      Overrides:
      toString in class Object