Class IterUtil
java.lang.Object
com.sure.tool.collection.IterUtil
迭代器工具类,参考 Hutool 的
IterUtil 设计。
所有方法对 null 迭代器/可迭代对象保持空安全;消耗迭代器的方法
(toList/size/getFirst/clear 等)会推进迭代器,
调用方不应在之后继续使用同一迭代器。
示例:
List<String> list = List.of("a", "bb", "ccc");
List<String> filtered = IterUtil.filterToList(list, s -> s.length() > 1); // [bb, ccc]
List<Integer> lengths = IterUtil.trans(list, String::length); // [1, 2, 3]
String joined = IterUtil.join(list, ","); // "a,bb,ccc"
null 语义:迭代器/可迭代对象为 null 时视为空(空安全),
getFirst 返回 null,其余集合类方法返回空集合/空串。
English: Iterator and stream convenience methods, including null-safe traversal and joining.
- Since:
- 1.19.1
- Author:
- suretool
-
Method Summary
Modifier and TypeMethodDescriptionstatic <E> Iterator<E> asIterator(Enumeration<E> enumeration) 将Enumeration转为迭代器。static void清空迭代器(消耗全部元素)。static <T> Iterator<T> empty()返回空迭代器。static <T> List<T> 过滤可迭代对象,返回新 List。static <T> List<T> filterToList(Iterator<T> iterator, Predicate<T> predicate) 过滤迭代器,返回新 List(消耗迭代器)。static <T> void遍历迭代器并执行消费操作(消耗迭代器)。static <T> T获取可迭代对象首元素。static <T> T获取迭代器首元素(消耗一个元素)。static <T> TgetFirstNoneNull(Iterable<T> iterable) 获取可迭代对象首个非null元素。static <T> TgetFirstNoneNull(Iterator<T> iterator) 获取迭代器首个非null元素(消耗迭代器直至命中或结束)。static <T> Iterator<T> 获取可迭代对象的迭代器。static boolean判断可迭代对象是否包含null元素。static boolean判断迭代器是否包含null元素(消耗迭代器)。static boolean判断可迭代对象是否全部为null(空集合返回false)。static boolean判断迭代器是否全部为null(空迭代器返回false)。static boolean判断可迭代对象是否为空。static boolean判断迭代器是否为空(不消耗元素)。static booleanisNotEmpty(Iterable<?> iterable) 判断可迭代对象是否非空。static booleanisNotEmpty(Iterator<?> iterator) 判断迭代器是否非空(不消耗元素)。static <T> Stringjoin(Iterator<T> iterator, CharSequence separator) 使用分隔符拼接迭代器元素(null元素输出"null")。static int统计可迭代对象元素个数。static int统计迭代器元素个数(消耗迭代器)。static <T> List<T> 将可迭代对象转为 List。static <T> List<T> 将迭代器转为 List(消耗迭代器)。static <F,T> Iterator <T> 转换迭代器元素类型(惰性求值)。
-
Method Details
-
getIter
-
empty
-
isEmpty
判断可迭代对象是否为空。- Parameters:
iterable- 可迭代对象,可为null- Returns:
- 无元素返回
true
-
isEmpty
判断迭代器是否为空(不消耗元素)。- Parameters:
iterator- 迭代器,可为null- Returns:
- 无元素返回
true
-
isNotEmpty
判断可迭代对象是否非空。- Parameters:
iterable- 可迭代对象,可为null- Returns:
- 有元素返回
true
-
isNotEmpty
判断迭代器是否非空(不消耗元素)。- Parameters:
iterator- 迭代器,可为null- Returns:
- 有元素返回
true
-
hasNull
判断可迭代对象是否包含null元素。- Parameters:
iterable- 可迭代对象,可为null- Returns:
- 含
null返回true
-
hasNull
判断迭代器是否包含null元素(消耗迭代器)。- Parameters:
iterator- 迭代器,可为null- Returns:
- 含
null返回true
-
isAllNull
判断可迭代对象是否全部为null(空集合返回false)。- Parameters:
iterable- 可迭代对象,可为null- Returns:
- 非空且全部为
null返回true
-
isAllNull
判断迭代器是否全部为null(空迭代器返回false)。- Parameters:
iterator- 迭代器,可为null- Returns:
- 非空且全部为
null返回true
-
size
统计可迭代对象元素个数。- Parameters:
iterable- 可迭代对象,可为null- Returns:
- 元素个数
-
size
统计迭代器元素个数(消耗迭代器)。- Parameters:
iterator- 迭代器,可为null- Returns:
- 元素个数
-
toList
-
toList
-
asIterator
将Enumeration转为迭代器。- Type Parameters:
E- 元素类型- Parameters:
enumeration- 枚举对象,可为null- Returns:
- 迭代器;
null返回空迭代器
-
getFirst
获取可迭代对象首元素。- Type Parameters:
T- 元素类型- Parameters:
iterable- 可迭代对象,可为null- Returns:
- 首元素;无元素返回
null
-
getFirst
获取迭代器首元素(消耗一个元素)。- Type Parameters:
T- 元素类型- Parameters:
iterator- 迭代器,可为null- Returns:
- 首元素;无元素返回
null
-
getFirstNoneNull
获取可迭代对象首个非null元素。- Type Parameters:
T- 元素类型- Parameters:
iterable- 可迭代对象,可为null- Returns:
- 首个非
null元素;无则返回null
-
getFirstNoneNull
获取迭代器首个非null元素(消耗迭代器直至命中或结束)。- Type Parameters:
T- 元素类型- Parameters:
iterator- 迭代器,可为null- Returns:
- 首个非
null元素;无则返回null
-
filter
-
filterToList
-
trans
-
join
使用分隔符拼接迭代器元素(null元素输出"null")。- Type Parameters:
T- 元素类型- Parameters:
iterator- 迭代器,可为nullseparator- 分隔符,null视为空串- Returns:
- 拼接结果;无元素返回空串
-
forEach
-
clear
-