cn.hutool.core.util.ArrayUtil Maven / Gradle / Ivy
Show all versions of hutool-all Show documentation
package cn.hutool.core.util;
import cn.hutool.core.collection.CollUtil;
import cn.hutool.core.collection.CollectionUtil;
import cn.hutool.core.collection.UniqueKeySet;
import cn.hutool.core.comparator.CompareUtil;
import cn.hutool.core.convert.Convert;
import cn.hutool.core.exceptions.UtilException;
import cn.hutool.core.lang.Assert;
import cn.hutool.core.lang.Editor;
import cn.hutool.core.lang.Filter;
import cn.hutool.core.lang.Matcher;
import cn.hutool.core.map.MapUtil;
import cn.hutool.core.text.StrJoiner;
import java.lang.reflect.Array;
import java.nio.ByteBuffer;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collection;
import java.util.Collections;
import java.util.Comparator;
import java.util.Iterator;
import java.util.LinkedHashSet;
import java.util.List;
import java.util.Map;
import java.util.Random;
import java.util.Set;
import java.util.function.Function;
import java.util.stream.Collectors;
/**
* 数组工具类
*
* @author Looly
*/
public class ArrayUtil extends PrimitiveArrayUtil {
// ---------------------------------------------------------------------- isEmpty
/**
* 数组是否为空
*
* @param 数组元素类型
* @param array 数组
* @return 是否为空
*/
public static boolean isEmpty(T[] array) {
return array == null || array.length == 0;
}
/**
* 如果给定数组为空，返回默认数组
*
* @param 数组元素类型
* @param array 数组
* @param defaultArray 默认数组
* @return 非空（empty）的原数组或默认数组
* @since 4.6.9
*/
public static T[] defaultIfEmpty(T[] array, T[] defaultArray) {
return isEmpty(array) ? defaultArray : array;
}
/**
* 数组是否为空
* 此方法会匹配单一对象，如果此对象为{@code null}则返回true
* 如果此对象为非数组，理解为此对象为数组的第一个元素，则返回false
* 如果此对象为数组对象，数组长度大于0情况下返回false，否则返回true
*
* @param array 数组
* @return 是否为空
*/
public static boolean isEmpty(Object array) {
if (array != null) {
if (isArray(array)) {
return 0 == Array.getLength(array);
}
return false;
}
return true;
}
// ---------------------------------------------------------------------- isNotEmpty
/**
* 数组是否为非空
*
* @param 数组元素类型
* @param array 数组
* @return 是否为非空
*/
public static boolean isNotEmpty(T[] array) {
return (null != array && array.length != 0);
}
/**
* 数组是否为非空
* 此方法会匹配单一对象，如果此对象为{@code null}则返回false
* 如果此对象为非数组，理解为此对象为数组的第一个元素，则返回true
* 如果此对象为数组对象，数组长度大于0情况下返回true，否则返回false
*
* @param array 数组
* @return 是否为非空
*/
public static boolean isNotEmpty(Object array) {
return !isEmpty(array);
}
/**
* 是否包含{@code null}元素
*
* @param 数组元素类型
* @param array 被检查的数组
* @return 是否包含{@code null}元素
* @since 3.0.7
*/
@SuppressWarnings("unchecked")
public static boolean hasNull(T... array) {
if (isNotEmpty(array)) {
for (T element : array) {
if (ObjectUtil.isNull(element)) {
return true;
}
}
}
return array == null;
}
/**
* 多个字段是否全为null
*
* @param 数组元素类型
* @param array 被检查的数组
* @return 多个字段是否全为null
* @author dahuoyzs
* @since 5.4.0
*/
@SuppressWarnings("unchecked")
public static boolean isAllNull(T... array) {
return null == firstNonNull(array);
}
/**
* 返回数组中第一个非空元素
*
* @param 数组元素类型
* @param array 数组
* @return 非空元素，如果不存在非空元素或数组为空，返回{@code null}
* @since 3.0.7
*/
@SuppressWarnings("unchecked")
public static T firstNonNull(T... array) {
return firstMatch(ObjectUtil::isNotNull, array);
}
/**
* 返回数组中第一个匹配规则的值
*
* @param 数组元素类型
* @param matcher 匹配接口，实现此接口自定义匹配规则
* @param array 数组
* @return 匹配元素，如果不存在匹配元素或数组为空，返回 {@code null}
* @since 3.0.7
*/
@SuppressWarnings("unchecked")
public static T firstMatch(Matcher matcher, T... array) {
final int index = matchIndex(matcher, array);
if (index < 0) {
return null;
}
return array[index];
}
/**
* 返回数组中第一个匹配规则的值的位置
*
* @param 数组元素类型
* @param matcher 匹配接口，实现此接口自定义匹配规则
* @param array 数组
* @return 匹配到元素的位置，-1表示未匹配到
* @since 5.6.6
*/
@SuppressWarnings("unchecked")
public static int matchIndex(Matcher matcher, T... array) {
return matchIndex(matcher, 0, array);
}
/**
* 返回数组中第一个匹配规则的值的位置
*
* @param 数组元素类型
* @param matcher 匹配接口，实现此接口自定义匹配规则
* @param beginIndexInclude 检索开始的位置
* @param array 数组
* @return 匹配到元素的位置，-1表示未匹配到
* @since 5.7.3
*/
@SuppressWarnings("unchecked")
public static int matchIndex(Matcher matcher, int beginIndexInclude, T... array) {
Assert.notNull(matcher, "Matcher must be not null !");
if (isNotEmpty(array)) {
for (int i = beginIndexInclude; i < array.length; i++) {
if (matcher.match(array[i])) {
return i;
}
}
}
return INDEX_NOT_FOUND;
}
/**
* 新建一个空数组
*
* @param 数组元素类型
* @param componentType 元素类型
* @param newSize 大小
* @return 空数组
*/
@SuppressWarnings("unchecked")
public static T[] newArray(Class componentType, int newSize) {
return (T[]) Array.newInstance(componentType, newSize);
}
/**
* 新建一个空数组
*
* @param newSize 大小
* @return 空数组
* @since 3.3.0
*/
public static Object[] newArray(int newSize) {
return new Object[newSize];
}
/**
* 获取数组对象的元素类型
*
* @param array 数组对象
* @return 元素类型
* @since 3.2.2
*/
public static Class getComponentType(Object array) {
return null == array ? null : array.getClass().getComponentType();
}
/**
* 获取数组对象的元素类型
*
* @param arrayClass 数组类
* @return 元素类型
* @since 3.2.2
*/
public static Class getComponentType(Class arrayClass) {
return null == arrayClass ? null : arrayClass.getComponentType();
}
/**
* 根据数组元素类型，获取数组的类型
* 方法是通过创建一个空数组从而获取其类型
*
* @param componentType 数组元素类型
* @return 数组类型
* @since 3.2.2
*/
public static Class getArrayType(Class componentType) {
return Array.newInstance(componentType, 0).getClass();
}
/**
* 强转数组类型
* 强制转换的前提是数组元素类型可被强制转换
* 强制转换后会生成一个新数组
*
* @param type 数组类型或数组元素类型
* @param arrayObj 原数组
* @return 转换后的数组类型
* @throws NullPointerException 提供参数为空
* @throws IllegalArgumentException 参数arrayObj不是数组
* @since 3.0.6
*/
public static Object[] cast(Class type, Object arrayObj) throws NullPointerException, IllegalArgumentException {
if (null == arrayObj) {
throw new NullPointerException("Argument [arrayObj] is null !");
}
if (false == arrayObj.getClass().isArray()) {
throw new IllegalArgumentException("Argument [arrayObj] is not array !");
}
if (null == type) {
return (Object[]) arrayObj;
}
final Class componentType = type.isArray() ? type.getComponentType() : type;
final Object[] array = (Object[]) arrayObj;
final Object[] result = ArrayUtil.newArray(componentType, array.length);
System.arraycopy(array, 0, result, 0, array.length);
return result;
}
/**
* 将新元素添加到已有数组中
* 添加新元素会生成一个新的数组，不影响原数组
*
* @param 数组元素类型
* @param buffer 已有数组
* @param newElements 新元素
* @return 新数组
*/
@SafeVarargs
public static T[] append(T[] buffer, T... newElements) {
if (isEmpty(buffer)) {
return newElements;
}
return insert(buffer, buffer.length, newElements);
}
/**
* 将新元素添加到已有数组中
* 添加新元素会生成一个新的数组，不影响原数组
*
* @param 数组元素类型
* @param array 已有数组
* @param newElements 新元素
* @return 新数组
*/
@SafeVarargs
public static Object append(Object array, T... newElements) {
if (isEmpty(array)) {
return newElements;
}
return insert(array, length(array), newElements);
}
/**
* 将元素值设置为数组的某个位置，当给定的index大于数组长度，则追加
*
* @param 数组元素类型
* @param buffer 已有数组
* @param index 位置，大于长度追加，否则替换
* @param value 新值
* @return 新数组或原有数组
* @since 4.1.2
*/
public static T[] setOrAppend(T[] buffer, int index, T value) {
if (index < buffer.length) {
Array.set(buffer, index, value);
return buffer;
} else {
if (ArrayUtil.isEmpty(buffer)) {
// issue#I5APJE
// 可变长类型在buffer为空的情况下，类型会被擦除，导致报错，此处修正
final T[] values = newArray(value.getClass(), 1);
values[0] = value;
return append(buffer, values);
}
return append(buffer, value);
}
}
/**
* 将元素值设置为数组的某个位置，当给定的index大于数组长度，则追加
* 替换时返回原数组，追加时返回新数组
*
* @param array 已有数组
* @param index 位置，大于长度追加，否则替换
* @param value 新值
* @return 新数组或原有数组
* @since 4.1.2
*/
public static Object setOrAppend(Object array, int index, Object value) {
if (index < length(array)) {
Array.set(array, index, value);
return array;
} else {
return append(array, value);
}
}
/**
* 将新元素插入到到已有数组中的某个位置
* 添加新元素会生成一个新数组或原有数组
* 如果插入位置为为负数，那么生成一个由插入元素顺序加已有数组顺序的新数组
*
* @param 数组元素类型
* @param buffer 已有数组
* @param index 位置，大于长度追加，否则替换，<0表示从头部追加
* @param values 新值
* @return 新数组或原有数组
* @since 5.7.23
*/
@SuppressWarnings({"unchecked"})
public static T[] replace(T[] buffer, int index, T... values) {
if (isEmpty(values)) {
return buffer;
}
if (isEmpty(buffer)) {
return values;
}
if (index < 0) {
// 从头部追加
return insert(buffer, 0, values);
}
if (index >= buffer.length) {
// 超出长度，尾部追加
return append(buffer, values);
}
if (buffer.length >= values.length + index) {
System.arraycopy(values, 0, buffer, index, values.length);
return buffer;
}
// 替换长度大于原数组长度，新建数组
int newArrayLength = index + values.length;
final T[] result = newArray(buffer.getClass().getComponentType(), newArrayLength);
System.arraycopy(buffer, 0, result, 0, index);
System.arraycopy(values, 0, result, index, values.length);
return result;
}
/**
* 将新元素插入到到已有数组中的某个位置
* 添加新元素会生成一个新的数组，不影响原数组
* 如果插入位置为为负数，从原数组从后向前计数，若大于原数组长度，则空白处用null填充
*
* @param 数组元素类型
* @param buffer 已有数组
* @param index 插入位置，此位置为对应此位置元素之前的空档
* @param newElements 新元素
* @return 新数组
* @since 4.0.8
*/
@SuppressWarnings("unchecked")
public static T[] insert(T[] buffer, int index, T... newElements) {
return (T[]) insert((Object) buffer, index, newElements);
}
/**
* 将新元素插入到到已有数组中的某个位置
* 添加新元素会生成一个新的数组，不影响原数组
* 如果插入位置为为负数，从原数组从后向前计数，若大于原数组长度，则空白处用null填充
*
* @param 数组元素类型
* @param array 已有数组
* @param index 插入位置，此位置为对应此位置元素之前的空档
* @param newElements 新元素
* @return 新数组
* @since 4.0.8
*/
@SuppressWarnings({"unchecked", "SuspiciousSystemArraycopy"})
public static Object insert(Object array, int index, T... newElements) {
if (isEmpty(newElements)) {
return array;
}
if (isEmpty(array)) {
return newElements;
}
final int len = length(array);
if (index < 0) {
index = (index % len) + len;
}
// 已有数组的元素类型
final Class originComponentType = array.getClass().getComponentType();
Object newEleArr = newElements;
// 如果 已有数组的元素类型是 原始类型，则需要转换 新元素数组 为该类型，避免ArrayStoreException
if (originComponentType.isPrimitive()) {
newEleArr = Convert.convert(array.getClass(), newElements);
}
final Object result = Array.newInstance(originComponentType, Math.max(len, index) + newElements.length);
System.arraycopy(array, 0, result, 0, Math.min(len, index));
System.arraycopy(newEleArr, 0, result, index, newElements.length);
if (index < len) {
System.arraycopy(array, index, result, index + newElements.length, len - index);
}
return result;
}
/**
* 生成一个新的重新设置大小的数组
* 调整大小后拷贝原数组到新数组下。扩大则占位前N个位置，缩小则截断
*
* @param 数组元素类型
* @param data 原数组
* @param newSize 新的数组大小
* @param componentType 数组元素类型
* @return 调整后的新数组
*/
public static T[] resize(T[] data, int newSize, Class componentType) {
if (newSize < 0) {
return data;
}
final T[] newArray = newArray(componentType, newSize);
if (newSize > 0 && isNotEmpty(data)) {
System.arraycopy(data, 0, newArray, 0, Math.min(data.length, newSize));
}
return newArray;
}
/**
* 生成一个新的重新设置大小的数组
* 调整大小后拷贝原数组到新数组下。扩大则占位前N个位置，其它位置补充0，缩小则截断
*
* @param array 原数组
* @param newSize 新的数组大小
* @return 调整后的新数组
* @since 4.6.7
*/
public static Object resize(Object array, int newSize) {
if (newSize < 0) {
return array;
}
if (null == array) {
return null;
}
final int length = length(array);
final Object newArray = Array.newInstance(array.getClass().getComponentType(), newSize);
if (newSize > 0 && isNotEmpty(array)) {
//noinspection SuspiciousSystemArraycopy
System.arraycopy(array, 0, newArray, 0, Math.min(length, newSize));
}
return newArray;
}
/**
* 生成一个新的重新设置大小的数组
* 新数组的类型为原数组的类型，调整大小后拷贝原数组到新数组下。扩大则占位前N个位置，缩小则截断
*
* @param 数组元素类型
* @param buffer 原数组
* @param newSize 新的数组大小
* @return 调整后的新数组
*/
public static T[] resize(T[] buffer, int newSize) {
return resize(buffer, newSize, buffer.getClass().getComponentType());
}
/**
* 将多个数组合并在一起
* 忽略null的数组
*
* @param 数组元素类型
* @param arrays 数组集合
* @return 合并后的数组
*/
@SafeVarargs
public static T[] addAll(T[]... arrays) {
if (arrays.length == 1) {
return arrays[0];
}
int length = 0;
for (final T[] array : arrays) {
if (isNotEmpty(array)) {
length += array.length;
}
}
final T[] result = newArray(arrays.getClass().getComponentType().getComponentType(), length);
length = 0;
for (final T[] array : arrays) {
if (isNotEmpty(array)) {
System.arraycopy(array, 0, result, length, array.length);
length += array.length;
}
}
return result;
}
/**
* 包装 {@link System#arraycopy(Object, int, Object, int, int)}
* 数组复制
*
* @param src 源数组
* @param srcPos 源数组开始位置
* @param dest 目标数组
* @param destPos 目标数组开始位置
* @param length 拷贝数组长度
* @return 目标数组
* @since 3.0.6
*/
public static Object copy(Object src, int srcPos, Object dest, int destPos, int length) {
//noinspection SuspiciousSystemArraycopy
System.arraycopy(src, srcPos, dest, destPos, length);
return dest;
}
/**
* 包装 {@link System#arraycopy(Object, int, Object, int, int)}
* 数组复制，缘数组和目标数组都是从位置0开始复制
*
* @param src 源数组
* @param dest 目标数组
* @param length 拷贝数组长度
* @return 目标数组
* @since 3.0.6
*/
public static Object copy(Object src, Object dest, int length) {
//noinspection SuspiciousSystemArraycopy
System.arraycopy(src, 0, dest, 0, length);
return dest;
}
/**
* 克隆数组
*
* @param 数组元素类型
* @param array 被克隆的数组
* @return 新数组
*/
public static T[] clone(T[] array) {
if (array == null) {
return null;
}
return array.clone();
}
/**
* 克隆数组，如果非数组返回{@code null}
*
* @param 数组元素类型
* @param obj 数组对象
* @return 克隆后的数组对象
*/
@SuppressWarnings("unchecked")
public static T clone(final T obj) {
if (null == obj) {
return null;
}
if (isArray(obj)) {
final Object result;
final Class componentType = obj.getClass().getComponentType();
if (componentType.isPrimitive()) {// 原始类型
int length = Array.getLength(obj);
result = Array.newInstance(componentType, length);
while (length-- > 0) {
Array.set(result, length, Array.get(obj, length));
}
} else {
result = ((Object[]) obj).clone();
}
return (T) result;
}
return null;
}
/**
* 编辑数组
* 编辑过程通过传入的Editor实现来返回需要的元素内容，这个Editor实现可以实现以下功能：
*
*
* 1、过滤出需要的对象，如果返回{@code null}表示这个元素对象抛弃
* 2、修改元素对象，返回集合中为修改后的对象
*
*
*
* @param 数组元素类型
* @param array 数组
* @param editor 编辑器接口，{@code null}返回原集合
* @return 编辑后的数组
* @since 5.3.3
*/
public static T[] edit(T[] array, Editor editor) {
if (null == editor) {
return array;
}
final ArrayList list = new ArrayList<>(array.length);
T modified;
for (T t : array) {
modified = editor.edit(t);
if (null != modified) {
list.add(modified);
}
}
final T[] result = newArray(array.getClass().getComponentType(), list.size());
return list.toArray(result);
}
/**
* 过滤
* 过滤过程通过传入的Filter实现来过滤返回需要的元素内容，这个Filter实现可以实现以下功能：
*
*
* 1、过滤出需要的对象，{@link Filter#accept(Object)}方法返回true的对象将被加入结果集合中
*
*
* @param 数组元素类型
* @param array 数组
* @param filter 过滤器接口，用于定义过滤规则，{@code null}返回原集合
* @return 过滤后的数组
* @since 3.2.1
*/
public static T[] filter(T[] array, Filter filter) {
if (null == array || null == filter) {
return array;
}
return edit(array, t -> filter.accept(t) ? t : null);
}
/**
* 去除{@code null} 元素
*
* @param 数组元素类型
* @param array 数组
* @return 处理后的数组
* @since 3.2.2
*/
public static T[] removeNull(T[] array) {
return edit(array, t -> {
// 返回null便不加入集合
return t;
});
}
/**
* 去除{@code null}或者"" 元素
*
* @param 数组元素类型
* @param array 数组
* @return 处理后的数组
* @since 3.2.2
*/
public static T[] removeEmpty(T[] array) {
return filter(array, StrUtil::isNotEmpty);
}
/**
* 去除{@code null}或者""或者空白字符串 元素
*
* @param 数组元素类型
* @param array 数组
* @return 处理后的数组
* @since 3.2.2
*/
public static T[] removeBlank(T[] array) {
return filter(array, StrUtil::isNotBlank);
}
/**
* 数组元素中的null转换为""
*
* @param array 数组
* @return 新数组
* @since 3.2.1
*/
public static String[] nullToEmpty(String[] array) {
return edit(array, t -> null == t ? StrUtil.EMPTY : t);
}
/**
* 映射键值（参考Python的zip()函数）
* 例如：
* keys = [a,b,c,d]
* values = [1,2,3,4]
* 则得到的Map是 {a=1, b=2, c=3, d=4}
* 如果两个数组长度不同，则只对应最短部分
*
* @param Key类型
* @param Value类型
* @param keys 键列表
* @param values 值列表
* @param isOrder 是否有序
* @return Map
* @since 3.0.4
*/
public static Map zip(K[] keys, V[] values, boolean isOrder) {
if (isEmpty(keys) || isEmpty(values)) {
return null;
}
final int size = Math.min(keys.length, values.length);
final Map map = MapUtil.newHashMap(size, isOrder);
for (int i = 0; i < size; i++) {
map.put(keys[i], values[i]);
}
return map;
}
/**
* 映射键值（参考Python的zip()函数），返回Map无序
* 例如：
* keys = [a,b,c,d]
* values = [1,2,3,4]
* 则得到的Map是 {a=1, b=2, c=3, d=4}
* 如果两个数组长度不同，则只对应最短部分
*
* @param Key类型
* @param Value类型
* @param keys 键列表
* @param values 值列表
* @return Map
*/
public static Map zip(K[] keys, V[] values) {
return zip(keys, values, false);
}
// ------------------------------------------------------------------- indexOf and lastIndexOf and contains
/**
* 返回数组中指定元素所在位置，未找到返回{@link #INDEX_NOT_FOUND}
*
* @param 数组类型
* @param array 数组
* @param value 被检查的元素
* @param beginIndexInclude 检索开始的位置
* @return 数组中指定元素所在位置，未找到返回{@link #INDEX_NOT_FOUND}
* @since 3.0.7
*/
public static int indexOf(T[] array, Object value, int beginIndexInclude) {
return matchIndex((obj) -> ObjectUtil.equal(value, obj), beginIndexInclude, array);
}
/**
* 返回数组中指定元素所在位置，未找到返回{@link #INDEX_NOT_FOUND}
*
* @param 数组类型
* @param array 数组
* @param value 被检查的元素
* @return 数组中指定元素所在位置，未找到返回{@link #INDEX_NOT_FOUND}
* @since 3.0.7
*/
public static int indexOf(T[] array, Object value) {
return matchIndex((obj) -> ObjectUtil.equal(value, obj), array);
}
/**
* 返回数组中指定元素所在位置，忽略大小写，未找到返回{@link #INDEX_NOT_FOUND}
*
* @param array 数组
* @param value 被检查的元素
* @return 数组中指定元素所在位置，未找到返回{@link #INDEX_NOT_FOUND}
* @since 3.1.2
*/
public static int indexOfIgnoreCase(CharSequence[] array, CharSequence value) {
if (null != array) {
for (int i = 0; i < array.length; i++) {
if (StrUtil.equalsIgnoreCase(array[i], value)) {
return i;
}
}
}
return INDEX_NOT_FOUND;
}
/**
* 返回数组中指定元素所在最后的位置，未找到返回{@link #INDEX_NOT_FOUND}
*
* @param 数组类型
* @param array 数组
* @param value 被检查的元素
* @return 数组中指定元素所在位置，未找到返回{@link #INDEX_NOT_FOUND}
* @since 3.0.7
*/
public static int lastIndexOf(T[] array, Object value) {
if (isEmpty(array)) {
return INDEX_NOT_FOUND;
}
return lastIndexOf(array, value, array.length - 1);
}
/**
* 返回数组中指定元素所在最后的位置，未找到返回{@link #INDEX_NOT_FOUND}
*
* @param 数组类型
* @param array 数组
* @param value 被检查的元素
* @param endInclude 查找方式为从后向前查找，查找的数组结束位置，一般为array.length-1
* @return 数组中指定元素所在位置，未找到返回{@link #INDEX_NOT_FOUND}
* @since 5.7.3
*/
public static int lastIndexOf(T[] array, Object value, int endInclude) {
if (isNotEmpty(array)) {
for (int i = endInclude; i >= 0; i--) {
if (ObjectUtil.equal(value, array[i])) {
return i;
}
}
}
return INDEX_NOT_FOUND;
}
/**
* 数组中是否包含元素
*
* @param 数组元素类型
* @param array 数组
* @param value 被检查的元素
* @return 是否包含
*/
public static boolean contains(T[] array, T value) {
return indexOf(array, value) > INDEX_NOT_FOUND;
}
/**
* 数组中是否包含指定元素中的任意一个
*
* @param 数组元素类型
* @param array 数组
* @param values 被检查的多个元素
* @return 是否包含指定元素中的任意一个
* @since 4.1.20
*/
@SuppressWarnings("unchecked")
public static boolean containsAny(T[] array, T... values) {
for (T value : values) {
if (contains(array, value)) {
return true;
}
}
return false;
}
/**
* 数组中是否包含指定元素中的全部
*
* @param 数组元素类型
* @param array 数组
* @param values 被检查的多个元素
* @return 是否包含指定元素中的全部
* @since 5.4.7
*/
@SuppressWarnings("unchecked")
public static boolean containsAll(T[] array, T... values) {
for (T value : values) {
if (false == contains(array, value)) {
return false;
}
}
return true;
}
/**
* 数组中是否包含元素，忽略大小写
*
* @param array 数组
* @param value 被检查的元素
* @return 是否包含
* @since 3.1.2
*/
public static boolean containsIgnoreCase(CharSequence[] array, CharSequence value) {
return indexOfIgnoreCase(array, value) > INDEX_NOT_FOUND;
}
// ------------------------------------------------------------------- Wrap and unwrap
/**
* 包装数组对象
*
* @param obj 对象，可以是对象数组或者基本类型数组
* @return 包装类型数组或对象数组
* @throws UtilException 对象为非数组
*/
public static Object[] wrap(Object obj) {
if (null == obj) {
return null;
}
if (isArray(obj)) {
try {
return (Object[]) obj;
} catch (Exception e) {
final String className = obj.getClass().getComponentType().getName();
switch (className) {
case "long":
return wrap((long[]) obj);
case "int":
return wrap((int[]) obj);
case "short":
return wrap((short[]) obj);
case "char":
return wrap((char[]) obj);
case "byte":
return wrap((byte[]) obj);
case "boolean":
return wrap((boolean[]) obj);
case "float":
return wrap((float[]) obj);
case "double":
return wrap((double[]) obj);
default:
throw new UtilException(e);
}
}
}
throw new UtilException(StrUtil.format("[{}] is not Array!", obj.getClass()));
}
/**
* 对象是否为数组对象
*
* @param obj 对象
* @return 是否为数组对象，如果为{@code null} 返回false
*/
public static boolean isArray(Object obj) {
return null != obj && obj.getClass().isArray();
}
/**
* 获取数组对象中指定index的值，支持负数，例如-1表示倒数第一个值
* 如果数组下标越界，返回null
*
* @param 数组元素类型
* @param array 数组对象
* @param index 下标，支持负数
* @return 值
* @since 4.0.6
*/
@SuppressWarnings("unchecked")
public static T get(Object array, int index) {
if (null == array) {
return null;
}
if (index < 0) {
index += Array.getLength(array);
}
try {
return (T) Array.get(array, index);
} catch (ArrayIndexOutOfBoundsException e) {
return null;
}
}
/**
* 获取数组中指定多个下标元素值，组成新数组
*
* @param 数组元素类型
* @param array 数组，如果提供为{@code null}则返回{@code null}
* @param indexes 下标列表
* @return 结果
*/
public static T[] getAny(Object array, int... indexes) {
if (null == array) {
return null;
}
if (null == indexes) {
return newArray(array.getClass().getComponentType(), 0);
}
final T[] result = newArray(array.getClass().getComponentType(), indexes.length);
for (int i = 0; i < indexes.length; i++) {
result[i] = ArrayUtil.get(array, indexes[i]);
}
return result;
}
/**
* 获取子数组
*
* @param 数组元素类型
* @param array 数组
* @param start 开始位置（包括）
* @param end 结束位置（不包括）
* @return 新的数组
* @see Arrays#copyOfRange(Object[], int, int)
* @since 4.2.2
*/
public static T[] sub(T[] array, int start, int end) {
int length = length(array);
if (start < 0) {
start += length;
}
if (end < 0) {
end += length;
}
if (start == length) {
return newArray(array.getClass().getComponentType(), 0);
}
if (start > end) {
int tmp = start;
start = end;
end = tmp;
}
if (end > length) {
if (start >= length) {
return newArray(array.getClass().getComponentType(), 0);
}
end = length;
}
return Arrays.copyOfRange(array, start, end);
}
/**
* 获取子数组
*
* @param array 数组
* @param start 开始位置（包括）
* @param end 结束位置（不包括）
* @return 新的数组
* @since 4.0.6
*/
public static Object[] sub(Object array, int start, int end) {
return sub(array, start, end, 1);
}
/**
* 获取子数组
*
* @param array 数组
* @param start 开始位置（包括）
* @param end 结束位置（不包括）
* @param step 步进
* @return 新的数组
* @since 4.0.6
*/
public static Object[] sub(Object array, int start, int end, int step) {
int length = length(array);
if (start < 0) {
start += length;
}
if (end < 0) {
end += length;
}
if (start == length) {
return new Object[0];
}
if (start > end) {
int tmp = start;
start = end;
end = tmp;
}
if (end > length) {
if (start >= length) {
return new Object[0];
}
end = length;
}
if (step <= 1) {
step = 1;
}
final ArrayList