IterUtil (hutool-core 4.6.1 API)

java.lang.Object
- cn.hutool.core.collection.IterUtil

```
public class IterUtil
extends Object
```
Iterable 和 Iterator 相关工具类

从以下版本开始:

3.1.0

作者:

Looly

构造器概要

构造器
构造器和说明

IterUtil()

构造器
构造器和说明
`IterUtil()`

方法概要

方法
限定符和类型	方法和说明
`static <E> Iterable<E>`	`asIterable(Iterator<E> iter)` `Iterator` 转为 `Iterable`
`static <E> Iterator<E>`	`asIterator(Enumeration<E> e)` Enumeration转换为Iterator Adapt the specified `Enumeration` to the `Iterator` interface
`static <T> Map<T,Integer>`	`countMap(Iterable<T> iter)` 根据集合返回一个元素计数的 `Map` 所谓元素计数就是假如这个集合中某个元素出现了n次，那将这个元素做为key，n做为value 例如：[a,b,c,c,c] 得到： a: 1 b: 1 c: 3
`static <T> Map<T,Integer>`	`countMap(Iterator<T> iter)` 根据集合返回一个元素计数的 `Map` 所谓元素计数就是假如这个集合中某个元素出现了n次，那将这个元素做为key，n做为value 例如：[a,b,c,c,c] 得到： a: 1 b: 1 c: 3
`static <K,V> Map<K,V>`	`fieldValueAsMap(Iterator<?> iter, String fieldNameForKey, String fieldNameForValue)` 两个字段值组成新的Map
`static <V> List<Object>`	`fieldValueList(Iterator<V> iter, String fieldName)` 获取指定Bean列表中某个字段，生成新的列表
`static <K,V> Map<K,V>`	`fieldValueMap(Iterable<V> iter, String fieldName)` 字段值与列表值对应的Map，常用于元素对象中有唯一ID时需要按照这个ID查找对象的情况例如：车牌号 =》车
`static <K,V> Map<K,V>`	`fieldValueMap(Iterator<V> iter, String fieldName)` 字段值与列表值对应的Map，常用于元素对象中有唯一ID时需要按照这个ID查找对象的情况例如：车牌号 =》车
`static Class<?>`	`getElementType(Iterable<?> iterable)` 获得`Iterable`对象的元素类型（通过第一个非空元素判断）注意，此方法至少会调用多次next方法
`static Class<?>`	`getElementType(Iterator<?> iterator)` 获得`Iterator`对象的元素类型（通过第一个非空元素判断）注意，此方法至少会调用多次next方法
`static <T> T`	`getFirst(Iterable<T> iterable)` 获取集合的第一个元素
`static <T> T`	`getFirst(Iterator<T> iterator)` 获取集合的第一个元素
`static boolean`	`hasNull(Iterable<?> iter)` 是否包含`null`元素
`static boolean`	`hasNull(Iterator<?> iter)` 是否包含`null`元素
`static boolean`	`isAllNull(Iterable<?> iter)` 是否全部元素为null
`static boolean`	`isAllNull(Iterator<?> iter)` 是否全部元素为null
`static boolean`	`isEmpty(Iterable<?> iterable)` Iterable是否为空
`static boolean`	`isEmpty(Iterator<?> Iterator)` Iterator是否为空
`static boolean`	`isNotEmpty(Iterable<?> iterable)` Iterable是否为空
`static boolean`	`isNotEmpty(Iterator<?> Iterator)` Iterator是否为空
`static <T> String`	`join(Iterable<T> iterable, CharSequence conjunction)` 以 conjunction 为分隔符将集合转换为字符串
`static <T> String`	`join(Iterable<T> iterable, CharSequence conjunction, String prefix, String suffix)` 以 conjunction 为分隔符将集合转换为字符串
`static <T> String`	`join(Iterator<T> iterator, CharSequence conjunction)` 以 conjunction 为分隔符将集合转换为字符串如果集合元素为数组、`Iterable`或`Iterator`，则递归组合其为字符串
`static <T> String`	`join(Iterator<T> iterator, CharSequence conjunction, String prefix, String suffix)` 以 conjunction 为分隔符将集合转换为字符串如果集合元素为数组、`Iterable`或`Iterator`，则递归组合其为字符串
`static <E> List<E>`	`toList(Iterable<E> iter)` Iterator转List 不判断，直接生成新的List
`static <E> List<E>`	`toList(Iterator<E> iter)` Iterator转List 不判断，直接生成新的List
`static <K,V> Map<K,V>`	`toMap(Iterable<K> keys, Iterable<V> values)` 将键列表和值列表转换为Map 以键为准，值与键位置需对应。
`static <K,V> Map<K,V>`	`toMap(Iterable<K> keys, Iterable<V> values, boolean isOrder)` 将键列表和值列表转换为Map 以键为准，值与键位置需对应。
`static <K,V> HashMap<K,V>`	`toMap(Iterable<Map.Entry<K,V>> entryIter)` 将Entry集合转换为HashMap
`static <K,V> Map<K,V>`	`toMap(Iterator<K> keys, Iterator<V> values)` 将键列表和值列表转换为Map 以键为准，值与键位置需对应。
`static <K,V> Map<K,V>`	`toMap(Iterator<K> keys, Iterator<V> values, boolean isOrder)` 将键列表和值列表转换为Map 以键为准，值与键位置需对应。

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - IterUtil
```
public IterUtil()
```
- 方法详细资料
  - isEmpty
```
public static boolean isEmpty(Iterable<?> iterable)
```
    Iterable是否为空
    
    参数:
    iterable - Iterable对象
    
    返回:
    是否为空
  - isEmpty
```
public static boolean isEmpty(Iterator<?> Iterator)
```
    Iterator是否为空
    
    参数:
    Iterator - Iterator对象
    
    返回:
    是否为空
  - isNotEmpty
```
public static boolean isNotEmpty(Iterable<?> iterable)
```
    Iterable是否为空
    
    参数:
    iterable - Iterable对象
    
    返回:
    是否为空
  - isNotEmpty
```
public static boolean isNotEmpty(Iterator<?> Iterator)
```
    Iterator是否为空
    
    参数:
    Iterator - Iterator对象
    
    返回:
    是否为空
  - hasNull
```
public static boolean hasNull(Iterable<?> iter)
```
    是否包含null元素
    
    参数:
    iter - 被检查的Iterable对象，如果为null 返回false
    
    返回:
    是否包含null元素
  - hasNull
```
public static boolean hasNull(Iterator<?> iter)
```
    是否包含null元素
    
    参数:
    iter - 被检查的Iterator对象，如果为null 返回false
    
    返回:
    是否包含null元素
  - isAllNull
```
public static boolean isAllNull(Iterable<?> iter)
```
    是否全部元素为null
    
    参数:
    iter - iter 被检查的Iterable对象，如果为null 返回true
    
    返回:
    是否全部元素为null
    从以下版本开始:
    
    3.3.0
  - isAllNull
```
public static boolean isAllNull(Iterator<?> iter)
```
    是否全部元素为null
    
    参数:
    iter - iter 被检查的Iterator对象，如果为null 返回true
    
    返回:
    是否全部元素为null
    从以下版本开始:
    
    3.3.0
  - countMap
```
public static <T> Map<T,Integer> countMap(Iterable<T> iter)
```
    根据集合返回一个元素计数的 Map
    所谓元素计数就是假如这个集合中某个元素出现了n次，那将这个元素做为key，n做为value
    例如：[a,b,c,c,c] 得到：
    a: 1
    b: 1
    c: 3
    
    类型参数:
    T - 集合元素类型
    参数:
    iter - Iterable，如果为null返回一个空的Map
    
    返回:
    Map
  - countMap
```
public static <T> Map<T,Integer> countMap(Iterator<T> iter)
```
    根据集合返回一个元素计数的 Map
    所谓元素计数就是假如这个集合中某个元素出现了n次，那将这个元素做为key，n做为value
    例如：[a,b,c,c,c] 得到：
    a: 1
    b: 1
    c: 3
    
    类型参数:
    T - 集合元素类型
    参数:
    iter - Iterator，如果为null返回一个空的Map
    
    返回:
    Map
  - fieldValueMap
```
public static <K,V> Map<K,V> fieldValueMap(Iterable<V> iter,
                           String fieldName)
```
    字段值与列表值对应的Map，常用于元素对象中有唯一ID时需要按照这个ID查找对象的情况
    例如：车牌号 =》车
    
    类型参数:
    K - 字段名对应值得类型，不确定请使用Object
    V - 对象类型
    参数:
    iter - 对象列表
    fieldName - 字段名（会通过反射获取其值）
    
    返回:
    某个字段值与对象对应Map
    从以下版本开始:
    
    4.0.4
  - fieldValueMap
```
public static <K,V> Map<K,V> fieldValueMap(Iterator<V> iter,
                           String fieldName)
```
    字段值与列表值对应的Map，常用于元素对象中有唯一ID时需要按照这个ID查找对象的情况
    例如：车牌号 =》车
    
    类型参数:
    K - 字段名对应值得类型，不确定请使用Object
    V - 对象类型
    参数:
    iter - 对象列表
    fieldName - 字段名（会通过反射获取其值）
    
    返回:
    某个字段值与对象对应Map
    从以下版本开始:
    
    4.0.4
  - fieldValueAsMap
```
public static <K,V> Map<K,V> fieldValueAsMap(Iterator<?> iter,
                             String fieldNameForKey,
                             String fieldNameForValue)
```
    两个字段值组成新的Map
    
    类型参数:
    K - 字段名对应值得类型，不确定请使用Object
    V - 值类型，不确定使用Object
    参数:
    iter - 对象列表
    fieldNameForKey - 做为键的字段名（会通过反射获取其值）
    fieldNameForValue - 做为值的字段名（会通过反射获取其值）
    
    返回:
    某个字段值与对象对应Map
    从以下版本开始:
    
    4.0.10
  - fieldValueList
```
public static <V> List<Object> fieldValueList(Iterator<V> iter,
                              String fieldName)
```
    获取指定Bean列表中某个字段，生成新的列表
    
    类型参数:
    V - 对象类型
    参数:
    iter - 对象列表
    fieldName - 字段名（会通过反射获取其值）
    
    返回:
    某个字段值与对象对应Map
    从以下版本开始:
    
    4.0.10
  - join
```
public static <T> String join(Iterable<T> iterable,
              CharSequence conjunction)
```
    以 conjunction 为分隔符将集合转换为字符串
    
    类型参数:
    T - 集合元素类型
    参数:
    iterable - Iterable
    conjunction - 分隔符
    
    返回:
    连接后的字符串
  - join
```
public static <T> String join(Iterable<T> iterable,
              CharSequence conjunction,
              String prefix,
              String suffix)
```
    以 conjunction 为分隔符将集合转换为字符串
    
    类型参数:
    T - 集合元素类型
    参数:
    iterable - Iterable
    conjunction - 分隔符
    prefix - 每个元素添加的前缀，null表示不添加
    suffix - 每个元素添加的后缀，null表示不添加
    
    返回:
    连接后的字符串
    从以下版本开始:
    
    4.0.10
  - join
```
public static <T> String join(Iterator<T> iterator,
              CharSequence conjunction)
```
    以 conjunction 为分隔符将集合转换为字符串
    如果集合元素为数组、Iterable或Iterator，则递归组合其为字符串
    
    类型参数:
    T - 集合元素类型
    参数:
    iterator - 集合
    conjunction - 分隔符
    
    返回:
    连接后的字符串
  - join
```
public static <T> String join(Iterator<T> iterator,
              CharSequence conjunction,
              String prefix,
              String suffix)
```
    以 conjunction 为分隔符将集合转换为字符串
    如果集合元素为数组、Iterable或Iterator，则递归组合其为字符串
    
    类型参数:
    T - 集合元素类型
    参数:
    iterator - 集合
    conjunction - 分隔符
    prefix - 每个元素添加的前缀，null表示不添加
    suffix - 每个元素添加的后缀，null表示不添加
    
    返回:
    连接后的字符串
    从以下版本开始:
    
    4.0.10
  - toMap
```
public static <K,V> HashMap<K,V> toMap(Iterable<Map.Entry<K,V>> entryIter)
```
    将Entry集合转换为HashMap
    
    类型参数:
    K - 键类型
    V - 值类型
    参数:
    entryIter - entry集合
    
    返回:
    Map
  - toMap
```
public static <K,V> Map<K,V> toMap(Iterable<K> keys,
                   Iterable<V> values)
```
    将键列表和值列表转换为Map
    以键为准，值与键位置需对应。如果键元素数多于值元素，多余部分值用null代替。
    如果值多于键，忽略多余的值。
    
    类型参数:
    K - 键类型
    V - 值类型
    参数:
    keys - 键列表
    values - 值列表
    
    返回:
    标题内容Map
    从以下版本开始:
    
    3.1.0
  - toMap
```
public static <K,V> Map<K,V> toMap(Iterable<K> keys,
                   Iterable<V> values,
                   boolean isOrder)
```
    将键列表和值列表转换为Map
    以键为准，值与键位置需对应。如果键元素数多于值元素，多余部分值用null代替。
    如果值多于键，忽略多余的值。
    
    类型参数:
    K - 键类型
    V - 值类型
    参数:
    keys - 键列表
    values - 值列表
    isOrder - 是否有序
    
    返回:
    标题内容Map
    从以下版本开始:
    
    4.1.12
  - toMap
```
public static <K,V> Map<K,V> toMap(Iterator<K> keys,
                   Iterator<V> values)
```
    将键列表和值列表转换为Map
    以键为准，值与键位置需对应。如果键元素数多于值元素，多余部分值用null代替。
    如果值多于键，忽略多余的值。
    
    类型参数:
    K - 键类型
    V - 值类型
    参数:
    keys - 键列表
    values - 值列表
    
    返回:
    标题内容Map
    从以下版本开始:
    
    3.1.0
  - toMap
```
public static <K,V> Map<K,V> toMap(Iterator<K> keys,
                   Iterator<V> values,
                   boolean isOrder)
```
    将键列表和值列表转换为Map
    以键为准，值与键位置需对应。如果键元素数多于值元素，多余部分值用null代替。
    如果值多于键，忽略多余的值。
    
    类型参数:
    K - 键类型
    V - 值类型
    参数:
    keys - 键列表
    values - 值列表
    isOrder - 是否有序
    
    返回:
    标题内容Map
    从以下版本开始:
    
    4.1.12
  - toList
```
public static <E> List<E> toList(Iterable<E> iter)
```
    Iterator转List
    不判断，直接生成新的List
    
    类型参数:
    E - 元素类型
    参数:
    iter - Iterator
    
    返回:
    List
    从以下版本开始:
    
    4.0.6
  - toList
```
public static <E> List<E> toList(Iterator<E> iter)
```
    Iterator转List
    不判断，直接生成新的List
    
    类型参数:
    E - 元素类型
    参数:
    iter - Iterator
    
    返回:
    List
    从以下版本开始:
    
    4.0.6
  - asIterator
```
public static <E> Iterator<E> asIterator(Enumeration<E> e)
```
    Enumeration转换为Iterator
    Adapt the specified Enumeration to the Iterator interface
    
    类型参数:
    E - 集合元素类型
    参数:
    e - Enumeration
    
    返回:
    Iterator
  - asIterable
```
public static <E> Iterable<E> asIterable(Iterator<E> iter)
```
    Iterator 转为 Iterable
    
    类型参数:
    E - 元素类型
    参数:
    iter - Iterator
    
    返回:
    Iterable
  - getFirst
```
public static <T> T getFirst(Iterable<T> iterable)
```
    获取集合的第一个元素
    
    类型参数:
    T - 集合元素类型
    参数:
    iterable - Iterable
    
    返回:
    第一个元素
  - getFirst
```
public static <T> T getFirst(Iterator<T> iterator)
```
    获取集合的第一个元素
    
    类型参数:
    T - 集合元素类型
    参数:
    iterator - Iterator
    
    返回:
    第一个元素
  - getElementType
```
public static Class<?> getElementType(Iterable<?> iterable)
```
    获得Iterable对象的元素类型（通过第一个非空元素判断）
    注意，此方法至少会调用多次next方法
    
    参数:
    iterable - Iterable
    
    返回:
    元素类型，当列表为空或元素全部为null时，返回null
  - getElementType
```
public static Class<?> getElementType(Iterator<?> iterator)
```
    获得Iterator对象的元素类型（通过第一个非空元素判断）
    注意，此方法至少会调用多次next方法
    
    参数:
    iterator - Iterator
    
    返回:
    元素类型，当列表为空或元素全部为null时，返回null

类 IterUtil

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

IterUtil

方法详细资料

isEmpty

isEmpty

isNotEmpty

isNotEmpty

hasNull

hasNull

isAllNull

isAllNull

countMap

countMap

fieldValueMap

fieldValueMap

fieldValueAsMap

fieldValueList

join

join

join

join

toMap

toMap

toMap

toMap

toMap

toList

toList

asIterator

asIterable

getFirst

getFirst

getElementType

getElementType