Please wait. This can take some minutes ...
Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $
You can buy this project and download/modify it how often you want.
com.dahuatech.hutool.core.util.ArrayUtil Maven / Gradle / Ivy
package com.dahuatech.hutool.core.util;
import com.dahuatech.hutool.core.collection.CollectionUtil;
import com.dahuatech.hutool.core.collection.IterUtil;
import com.dahuatech.hutool.core.exceptions.UtilException;
import com.dahuatech.hutool.core.lang.Editor;
import com.dahuatech.hutool.core.lang.Filter;
import java.lang.reflect.Array;
import java.nio.ByteBuffer;
import java.util.*;
/**
* 数组工具类
*
* @author Looly
*/
public class ArrayUtil {
/** 数组中元素未找到的下标,值为-1 */
public static final int INDEX_NOT_FOUND = -1;
// ---------------------------------------------------------------------- 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 (null == array) {
return true;
} else if (isArray(array)) {
return 0 == Array.getLength(array);
}
throw new UtilException("Object to provide is not a Array !");
}
/**
* 数组是否为空
*
* @param array 数组
* @return 是否为空
*/
public static boolean isEmpty(long[] array) {
return array == null || array.length == 0;
}
/**
* 数组是否为空
*
* @param array 数组
* @return 是否为空
*/
public static boolean isEmpty(int[] array) {
return array == null || array.length == 0;
}
/**
* 数组是否为空
*
* @param array 数组
* @return 是否为空
*/
public static boolean isEmpty(short[] array) {
return array == null || array.length == 0;
}
/**
* 数组是否为空
*
* @param array 数组
* @return 是否为空
*/
public static boolean isEmpty(char[] array) {
return array == null || array.length == 0;
}
/**
* 数组是否为空
*
* @param array 数组
* @return 是否为空
*/
public static boolean isEmpty(byte[] array) {
return array == null || array.length == 0;
}
/**
* 数组是否为空
*
* @param array 数组
* @return 是否为空
*/
public static boolean isEmpty(double[] array) {
return array == null || array.length == 0;
}
/**
* 数组是否为空
*
* @param array 数组
* @return 是否为空
*/
public static boolean isEmpty(float[] array) {
return array == null || array.length == 0;
}
/**
* 数组是否为空
*
* @param array 数组
* @return 是否为空
*/
public static boolean isEmpty(boolean[] array) {
return array == null || array.length == 0;
}
// ---------------------------------------------------------------------- isNotEmpty
/**
* 数组是否为非空
*
* @param 数组元素类型
* @param array 数组
* @return 是否为非空
*/
public static boolean isNotEmpty(T[] array) {
return (array != null && array.length != 0);
}
/**
* 数组是否为非空
* 此方法会匹配单一对象,如果此对象为{@code null}则返回false
* 如果此对象为非数组,理解为此对象为数组的第一个元素,则返回true
* 如果此对象为数组对象,数组长度大于0情况下返回true,否则返回false
*
* @param array 数组
* @return 是否为非空
*/
public static boolean isNotEmpty(Object array) {
return false == isEmpty(array);
}
/**
* 数组是否为非空
*
* @param array 数组
* @return 是否为非空
*/
public static boolean isNotEmpty(long[] array) {
return false == isEmpty(array);
}
/**
* 数组是否为非空
*
* @param array 数组
* @return 是否为非空
*/
public static boolean isNotEmpty(int[] array) {
return false == isEmpty(array);
}
/**
* 数组是否为非空
*
* @param array 数组
* @return 是否为非空
*/
public static boolean isNotEmpty(short[] array) {
return false == isEmpty(array);
}
/**
* 数组是否为非空
*
* @param array 数组
* @return 是否为非空
*/
public static boolean isNotEmpty(char[] array) {
return false == isEmpty(array);
}
/**
* 数组是否为非空
*
* @param array 数组
* @return 是否为非空
*/
public static boolean isNotEmpty(byte[] array) {
return false == isEmpty(array);
}
/**
* 数组是否为非空
*
* @param array 数组
* @return 是否为非空
*/
public static boolean isNotEmpty(double[] array) {
return false == isEmpty(array);
}
/**
* 数组是否为非空
*
* @param array 数组
* @return 是否为非空
*/
public static boolean isNotEmpty(float[] array) {
return false == isEmpty(array);
}
/**
* 数组是否为非空
*
* @param array 数组
* @return 是否为非空
*/
public static boolean isNotEmpty(boolean[] array) {
return false == 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 (null == element) {
return true;
}
}
}
return false;
}
/**
* 返回数组中第一个非空元素
*
* @param 数组元素类型
* @param array 数组
* @return 非空元素,如果不存在非空元素或数组为空,返回{@code null}
* @since 3.0.7
*/
@SuppressWarnings("unchecked")
public static T firstNonNull(T... array) {
if (isNotEmpty(array)) {
for (final T val : array) {
if (null != val) {
return val;
}
}
}
return null;
}
/**
* 新建一个空数组
*
* @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 {
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);
}
}
/**
* 将新元素插入到到已有数组中的某个位置
* 添加新元素会生成一个新的数组,不影响原数组
* 如果插入位置为为负数,从原数组从后向前计数,若大于原数组长度,则空白处用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")
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 T[] result =
newArray(array.getClass().getComponentType(), Math.max(len, index) + newElements.length);
System.arraycopy(array, 0, result, 0, Math.min(len, index));
System.arraycopy(newElements, 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)) {
System.arraycopy(array, 0, newArray, 0, Math.min(length, newSize));
}
return newArray;
}
/**
* 生成一个新的重新设置大小的数组
* 调整大小后拷贝原数组到新数组下。扩大则占位前N个位置,其它位置补充0,缩小则截断
*
* @param bytes 原数组
* @param newSize 新的数组大小
* @return 调整后的新数组
* @since 4.6.7
*/
public static byte[] resize(byte[] bytes, int newSize) {
if (newSize < 0) {
return bytes;
}
final byte[] newArray = new byte[newSize];
if (newSize > 0 && isNotEmpty(bytes)) {
System.arraycopy(bytes, 0, newArray, 0, Math.min(bytes.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 (T[] array : arrays) {
if (null != array) {
length += array.length;
}
}
T[] result = newArray(arrays.getClass().getComponentType().getComponentType(), length);
length = 0;
for (T[] array : arrays) {
if (null != array) {
System.arraycopy(array, 0, result, length, array.length);
length += array.length;
}
}
return result;
}
/**
* 将多个数组合并在一起
* 忽略null的数组
*
* @param arrays 数组集合
* @return 合并后的数组
* @since 4.6.9
*/
public static byte[] addAll(byte[]... arrays) {
if (arrays.length == 1) {
return arrays[0];
}
// 计算总长度
int length = 0;
for (byte[] array : arrays) {
if (null != array) {
length += array.length;
}
}
final byte[] result = new byte[length];
length = 0;
for (byte[] array : arrays) {
if (null != 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) {
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) {
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();
}
/**
* 克隆数组,如果非数组返回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;
}
/**
* 生成一个从0开始的数字列表
*
* @param excludedEnd 结束的数字(不包含)
* @return 数字列表
*/
public static int[] range(int excludedEnd) {
return range(0, excludedEnd, 1);
}
/**
* 生成一个数字列表
* 自动判定正序反序
*
* @param includedStart 开始的数字(包含)
* @param excludedEnd 结束的数字(不包含)
* @return 数字列表
*/
public static int[] range(int includedStart, int excludedEnd) {
return range(includedStart, excludedEnd, 1);
}
/**
* 生成一个数字列表
* 自动判定正序反序
*
* @param includedStart 开始的数字(包含)
* @param excludedEnd 结束的数字(不包含)
* @param step 步进
* @return 数字列表
*/
public static int[] range(int includedStart, int excludedEnd, int step) {
if (includedStart > excludedEnd) {
int tmp = includedStart;
includedStart = excludedEnd;
excludedEnd = tmp;
}
if (step <= 0) {
step = 1;
}
int deviation = excludedEnd - includedStart;
int length = deviation / step;
if (deviation % step != 0) {
length += 1;
}
int[] range = new int[length];
for (int i = 0; i < length; i++) {
range[i] = includedStart;
includedStart += step;
}
return range;
}
/**
* 拆分byte数组为几个等份(最后一份可能小于len)
*
* @param array 数组
* @param len 每个小节的长度
* @return 拆分后的数组
*/
public static byte[][] split(byte[] array, int len) {
int x = array.length / len;
int y = array.length % len;
int z = 0;
if (y != 0) {
z = 1;
}
byte[][] arrays = new byte[x + z][];
byte[] arr;
for (int i = 0; i < x + z; i++) {
arr = new byte[len];
if (i == x + z - 1 && y != 0) {
System.arraycopy(array, i * len, arr, 0, y);
} else {
System.arraycopy(array, i * len, arr, 0, len);
}
arrays[i] = arr;
}
return arrays;
}
/**
* 过滤
* 过滤过程通过传入的Editor实现来返回需要的元素内容,这个Editor实现可以实现以下功能:
*
*
* 1、过滤出需要的对象,如果返回null表示这个元素对象抛弃
* 2、修改元素对象,返回集合中为修改后的对象
*
*
* @param 数组元素类型
* @param array 数组
* @param editor 编辑器接口
* @return 过滤后的数组
*/
public static T[] filter(T[] array, Editor editor) {
ArrayList list = new ArrayList<>(array.length);
T modified;
for (T t : array) {
modified = editor.edit(t);
if (null != modified) {
list.add(modified);
}
}
return list.toArray(Arrays.copyOf(array, list.size()));
}
/**
* 过滤
* 过滤过程通过传入的Filter实现来过滤返回需要的元素内容,这个Filter实现可以实现以下功能:
*
*
* 1、过滤出需要的对象,{@link Filter#accept(Object)}方法返回true的对象将被加入结果集合中
*
*
* @param 数组元素类型
* @param array 数组
* @param filter 过滤器接口,用于定义过滤规则,null表示不过滤,返回原数组
* @return 过滤后的数组
* @since 3.2.1
*/
public static T[] filter(T[] array, Filter filter) {
if (null == filter) {
return array;
}
final ArrayList list = new ArrayList<>(array.length);
for (T t : array) {
if (filter.accept(t)) {
list.add(t);
}
}
final T[] result = newArray(array.getClass().getComponentType(), list.size());
return list.toArray(result);
}
/**
* 去除{@code null} 元素
*
* @param 数组元素类型
* @param array 数组
* @return 处理后的数组
* @since 3.2.2
*/
public static T[] removeNull(T[] array) {
return filter(
array,
new Editor() {
@Override
public T edit(T t) {
// 返回null便不加入集合
return t;
}
});
}
/**
* 去除{@code null}或者"" 元素
*
* @param 数组元素类型
* @param array 数组
* @return 处理后的数组
* @since 3.2.2
*/
public static T[] removeEmpty(T[] array) {
return filter(
array,
new Filter() {
@Override
public boolean accept(T t) {
return false == StrUtil.isEmpty(t);
}
});
}
/**
* 去除{@code null}或者""或者空白字符串 元素
*
* @param 数组元素类型
* @param array 数组
* @return 处理后的数组
* @since 3.2.2
*/
public static T[] removeBlank(T[] array) {
return filter(
array,
new Filter() {
@Override
public boolean accept(T t) {
return false == StrUtil.isBlank(t);
}
});
}
/**
* 数组元素中的null转换为""
*
* @param array 数组
* @return 新数组
* @since 3.2.1
*/
public static String[] nullToEmpty(String[] array) {
return filter(
array,
new Editor() {
@Override
public String edit(String t) {
return 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 = CollectionUtil.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 被检查的元素
* @return 数组中指定元素所在位置,未找到返回{@link #INDEX_NOT_FOUND}
* @since 3.0.7
*/
public static int indexOf(T[] array, Object value) {
if (null != array) {
for (int i = 0; i < array.length; i++) {
if (ObjectUtil.equal(value, array[i])) {
return i;
}
}
}
return INDEX_NOT_FOUND;
}
/**
* 返回数组中指定元素所在位置,忽略大小写,未找到返回{@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 (null != array) {
for (int i = array.length - 1; 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 array 数组
* @param value 被检查的元素
* @return 是否包含
* @since 3.1.2
*/
public static boolean containsIgnoreCase(CharSequence[] array, CharSequence value) {
return indexOfIgnoreCase(array, value) > INDEX_NOT_FOUND;
}
/**
* 返回数组中指定元素所在位置,未找到返回{@link #INDEX_NOT_FOUND}
*
* @param array 数组
* @param value 被检查的元素
* @return 数组中指定元素所在位置,未找到返回{@link #INDEX_NOT_FOUND}
* @since 3.0.7
*/
public static int indexOf(long[] array, long value) {
if (null != array) {
for (int i = 0; i < array.length; i++) {
if (value == array[i]) {
return i;
}
}
}
return INDEX_NOT_FOUND;
}
/**
* 返回数组中指定元素所在最后的位置,未找到返回{@link #INDEX_NOT_FOUND}
*
* @param array 数组
* @param value 被检查的元素
* @return 数组中指定元素所在位置,未找到返回{@link #INDEX_NOT_FOUND}
* @since 3.0.7
*/
public static int lastIndexOf(long[] array, long value) {
if (null != array) {
for (int i = array.length - 1; i >= 0; i--) {
if (value == array[i]) {
return i;
}
}
}
return INDEX_NOT_FOUND;
}
/**
* 数组中是否包含元素
*
* @param array 数组
* @param value 被检查的元素
* @return 是否包含
* @since 3.0.7
*/
public static boolean contains(long[] array, long value) {
return indexOf(array, value) > INDEX_NOT_FOUND;
}
/**
* 返回数组中指定元素所在位置,未找到返回{@link #INDEX_NOT_FOUND}
*
* @param array 数组
* @param value 被检查的元素
* @return 数组中指定元素所在位置,未找到返回{@link #INDEX_NOT_FOUND}
* @since 3.0.7
*/
public static int indexOf(int[] array, int value) {
if (null != array) {
for (int i = 0; i < array.length; i++) {
if (value == array[i]) {
return i;
}
}
}
return INDEX_NOT_FOUND;
}
/**
* 返回数组中指定元素所在最后的位置,未找到返回{@link #INDEX_NOT_FOUND}
*
* @param array 数组
* @param value 被检查的元素
* @return 数组中指定元素所在位置,未找到返回{@link #INDEX_NOT_FOUND}
* @since 3.0.7
*/
public static int lastIndexOf(int[] array, int value) {
if (null != array) {
for (int i = array.length - 1; i >= 0; i--) {
if (value == array[i]) {
return i;
}
}
}
return INDEX_NOT_FOUND;
}
/**
* 数组中是否包含元素
*
* @param array 数组
* @param value 被检查的元素
* @return 是否包含
* @since 3.0.7
*/
public static boolean contains(int[] array, int value) {
return indexOf(array, value) > INDEX_NOT_FOUND;
}
/**
* 返回数组中指定元素所在位置,未找到返回{@link #INDEX_NOT_FOUND}
*
* @param array 数组
* @param value 被检查的元素
* @return 数组中指定元素所在位置,未找到返回{@link #INDEX_NOT_FOUND}
* @since 3.0.7
*/
public static int indexOf(short[] array, short value) {
if (null != array) {
for (int i = 0; i < array.length; i++) {
if (value == array[i]) {
return i;
}
}
}
return INDEX_NOT_FOUND;
}
/**
* 返回数组中指定元素所在最后的位置,未找到返回{@link #INDEX_NOT_FOUND}
*
* @param array 数组
* @param value 被检查的元素
* @return 数组中指定元素所在位置,未找到返回{@link #INDEX_NOT_FOUND}
* @since 3.0.7
*/
public static int lastIndexOf(short[] array, short value) {
if (null != array) {
for (int i = array.length - 1; i >= 0; i--) {
if (value == array[i]) {
return i;
}
}
}
return INDEX_NOT_FOUND;
}
/**
* 数组中是否包含元素
*
* @param array 数组
* @param value 被检查的元素
* @return 是否包含
* @since 3.0.7
*/
public static boolean contains(short[] array, short value) {
return indexOf(array, value) > INDEX_NOT_FOUND;
}
/**
* 返回数组中指定元素所在位置,未找到返回{@link #INDEX_NOT_FOUND}
*
* @param array 数组
* @param value 被检查的元素
* @return 数组中指定元素所在位置,未找到返回{@link #INDEX_NOT_FOUND}
* @since 3.0.7
*/
public static int indexOf(char[] array, char value) {
if (null != array) {
for (int i = 0; i < array.length; i++) {
if (value == array[i]) {
return i;
}
}
}
return INDEX_NOT_FOUND;
}
/**
* 返回数组中指定元素所在最后的位置,未找到返回{@link #INDEX_NOT_FOUND}
*
* @param array 数组
* @param value 被检查的元素
* @return 数组中指定元素所在位置,未找到返回{@link #INDEX_NOT_FOUND}
* @since 3.0.7
*/
public static int lastIndexOf(char[] array, char value) {
if (null != array) {
for (int i = array.length - 1; i >= 0; i--) {
if (value == array[i]) {
return i;
}
}
}
return INDEX_NOT_FOUND;
}
/**
* 数组中是否包含元素
*
* @param array 数组
* @param value 被检查的元素
* @return 是否包含
* @since 3.0.7
*/
public static boolean contains(char[] array, char value) {
return indexOf(array, value) > INDEX_NOT_FOUND;
}
/**
* 返回数组中指定元素所在位置,未找到返回{@link #INDEX_NOT_FOUND}
*
* @param array 数组
* @param value 被检查的元素
* @return 数组中指定元素所在位置,未找到返回{@link #INDEX_NOT_FOUND}
* @since 3.0.7
*/
public static int indexOf(byte[] array, byte value) {
if (null != array) {
for (int i = 0; i < array.length; i++) {
if (value == array[i]) {
return i;
}
}
}
return INDEX_NOT_FOUND;
}
/**
* 返回数组中指定元素所在最后的位置,未找到返回{@link #INDEX_NOT_FOUND}
*
* @param array 数组
* @param value 被检查的元素
* @return 数组中指定元素所在位置,未找到返回{@link #INDEX_NOT_FOUND}
* @since 3.0.7
*/
public static int lastIndexOf(byte[] array, byte value) {
if (null != array) {
for (int i = array.length - 1; i >= 0; i--) {
if (value == array[i]) {
return i;
}
}
}
return INDEX_NOT_FOUND;
}
/**
* 数组中是否包含元素
*
* @param array 数组
* @param value 被检查的元素
* @return 是否包含
* @since 3.0.7
*/
public static boolean contains(byte[] array, byte value) {
return indexOf(array, value) > INDEX_NOT_FOUND;
}
/**
* 返回数组中指定元素所在位置,未找到返回{@link #INDEX_NOT_FOUND}
*
* @param array 数组
* @param value 被检查的元素
* @return 数组中指定元素所在位置,未找到返回{@link #INDEX_NOT_FOUND}
* @since 3.0.7
*/
public static int indexOf(double[] array, double value) {
if (null != array) {
for (int i = 0; i < array.length; i++) {
if (value == array[i]) {
return i;
}
}
}
return INDEX_NOT_FOUND;
}
/**
* 返回数组中指定元素所在最后的位置,未找到返回{@link #INDEX_NOT_FOUND}
*
* @param array 数组
* @param value 被检查的元素
* @return 数组中指定元素所在位置,未找到返回{@link #INDEX_NOT_FOUND}
* @since 3.0.7
*/
public static int lastIndexOf(double[] array, double value) {
if (null != array) {
for (int i = array.length - 1; i >= 0; i--) {
if (value == array[i]) {
return i;
}
}
}
return INDEX_NOT_FOUND;
}
/**
* 数组中是否包含元素
*
* @param array 数组
* @param value 被检查的元素
* @return 是否包含
* @since 3.0.7
*/
public static boolean contains(double[] array, double value) {
return indexOf(array, value) > INDEX_NOT_FOUND;
}
/**
* 返回数组中指定元素所在位置,未找到返回{@link #INDEX_NOT_FOUND}
*
* @param array 数组
* @param value 被检查的元素
* @return 数组中指定元素所在位置,未找到返回{@link #INDEX_NOT_FOUND}
* @since 3.0.7
*/
public static int indexOf(float[] array, float value) {
if (null != array) {
for (int i = 0; i < array.length; i++) {
if (value == array[i]) {
return i;
}
}
}
return INDEX_NOT_FOUND;
}
/**
* 返回数组中指定元素所在最后的位置,未找到返回{@link #INDEX_NOT_FOUND}
*
* @param array 数组
* @param value 被检查的元素
* @return 数组中指定元素所在位置,未找到返回{@link #INDEX_NOT_FOUND}
* @since 3.0.7
*/
public static int lastIndexOf(float[] array, float value) {
if (null != array) {
for (int i = array.length - 1; i >= 0; i--) {
if (value == array[i]) {
return i;
}
}
}
return INDEX_NOT_FOUND;
}
/**
* 数组中是否包含元素
*
* @param array 数组
* @param value 被检查的元素
* @return 是否包含
* @since 3.0.7
*/
public static boolean contains(float[] array, float value) {
return indexOf(array, value) > INDEX_NOT_FOUND;
}
/**
* 返回数组中指定元素所在位置,未找到返回{@link #INDEX_NOT_FOUND}
*
* @param array 数组
* @param value 被检查的元素
* @return 数组中指定元素所在位置,未找到返回{@link #INDEX_NOT_FOUND}
* @since 3.0.7
*/
public static int indexOf(boolean[] array, boolean value) {
if (null != array) {
for (int i = 0; i < array.length; i++) {
if (value == array[i]) {
return i;
}
}
}
return INDEX_NOT_FOUND;
}
/**
* 返回数组中指定元素所在最后的位置,未找到返回{@link #INDEX_NOT_FOUND}
*
* @param array 数组
* @param value 被检查的元素
* @return 数组中指定元素所在位置,未找到返回{@link #INDEX_NOT_FOUND}
* @since 3.0.7
*/
public static int lastIndexOf(boolean[] array, boolean value) {
if (null != array) {
for (int i = array.length - 1; i >= 0; i--) {
if (value == array[i]) {
return i;
}
}
}
return INDEX_NOT_FOUND;
}
/**
* 数组中是否包含元素
*
* @param array 数组
* @param value 被检查的元素
* @return 是否包含
* @since 3.0.7
*/
public static boolean contains(boolean[] array, boolean value) {
return indexOf(array, value) > INDEX_NOT_FOUND;
}
// ------------------------------------------------------------------- Wrap and unwrap
/**
* 将原始类型数组包装为包装类型
*
* @param values 原始类型数组
* @return 包装类型数组
*/
public static Integer[] wrap(int... values) {
if (null == values) {
return null;
}
final int length = values.length;
if (0 == length) {
return new Integer[0];
}
final Integer[] array = new Integer[length];
for (int i = 0; i < length; i++) {
array[i] = Integer.valueOf(values[i]);
}
return array;
}
/**
* 包装类数组转为原始类型数组
*
* @param values 包装类型数组
* @return 原始类型数组
*/
public static int[] unWrap(Integer... values) {
if (null == values) {
return null;
}
final int length = values.length;
if (0 == length) {
return new int[0];
}
final int[] array = new int[length];
for (int i = 0; i < length; i++) {
array[i] = values[i].intValue();
}
return array;
}
/**
* 将原始类型数组包装为包装类型
*
* @param values 原始类型数组
* @return 包装类型数组
*/
public static Long[] wrap(long... values) {
if (null == values) {
return null;
}
final int length = values.length;
if (0 == length) {
return new Long[0];
}
final Long[] array = new Long[length];
for (int i = 0; i < length; i++) {
array[i] = Long.valueOf(values[i]);
}
return array;
}
/**
* 包装类数组转为原始类型数组
*
* @param values 包装类型数组
* @return 原始类型数组
*/
public static long[] unWrap(Long... values) {
if (null == values) {
return null;
}
final int length = values.length;
if (0 == length) {
return new long[0];
}
final long[] array = new long[length];
for (int i = 0; i < length; i++) {
array[i] = values[i].longValue();
}
return array;
}
/**
* 将原始类型数组包装为包装类型
*
* @param values 原始类型数组
* @return 包装类型数组
*/
public static Character[] wrap(char... values) {
if (null == values) {
return null;
}
final int length = values.length;
if (0 == length) {
return new Character[0];
}
final Character[] array = new Character[length];
for (int i = 0; i < length; i++) {
array[i] = Character.valueOf(values[i]);
}
return array;
}
/**
* 包装类数组转为原始类型数组
*
* @param values 包装类型数组
* @return 原始类型数组
*/
public static char[] unWrap(Character... values) {
if (null == values) {
return null;
}
final int length = values.length;
if (0 == length) {
return new char[0];
}
char[] array = new char[length];
for (int i = 0; i < length; i++) {
array[i] = values[i].charValue();
}
return array;
}
/**
* 将原始类型数组包装为包装类型
*
* @param values 原始类型数组
* @return 包装类型数组
*/
public static Byte[] wrap(byte... values) {
if (null == values) {
return null;
}
final int length = values.length;
if (0 == length) {
return new Byte[0];
}
final Byte[] array = new Byte[length];
for (int i = 0; i < length; i++) {
array[i] = Byte.valueOf(values[i]);
}
return array;
}
/**
* 包装类数组转为原始类型数组
*
* @param values 包装类型数组
* @return 原始类型数组
*/
public static byte[] unWrap(Byte... values) {
if (null == values) {
return null;
}
final int length = values.length;
if (0 == length) {
return new byte[0];
}
final byte[] array = new byte[length];
for (int i = 0; i < length; i++) {
array[i] = values[i].byteValue();
}
return array;
}
/**
* 将原始类型数组包装为包装类型
*
* @param values 原始类型数组
* @return 包装类型数组
*/
public static Short[] wrap(short... values) {
if (null == values) {
return null;
}
final int length = values.length;
if (0 == length) {
return new Short[0];
}
final Short[] array = new Short[length];
for (int i = 0; i < length; i++) {
array[i] = Short.valueOf(values[i]);
}
return array;
}
/**
* 包装类数组转为原始类型数组
*
* @param values 包装类型数组
* @return 原始类型数组
*/
public static short[] unWrap(Short... values) {
if (null == values) {
return null;
}
final int length = values.length;
if (0 == length) {
return new short[0];
}
final short[] array = new short[length];
for (int i = 0; i < length; i++) {
array[i] = values[i].shortValue();
}
return array;
}
/**
* 将原始类型数组包装为包装类型
*
* @param values 原始类型数组
* @return 包装类型数组
*/
public static Float[] wrap(float... values) {
if (null == values) {
return null;
}
final int length = values.length;
if (0 == length) {
return new Float[0];
}
final Float[] array = new Float[length];
for (int i = 0; i < length; i++) {
array[i] = Float.valueOf(values[i]);
}
return array;
}
/**
* 包装类数组转为原始类型数组
*
* @param values 包装类型数组
* @return 原始类型数组
*/
public static float[] unWrap(Float... values) {
if (null == values) {
return null;
}
final int length = values.length;
if (0 == length) {
return new float[0];
}
final float[] array = new float[length];
for (int i = 0; i < length; i++) {
array[i] = values[i].floatValue();
}
return array;
}
/**
* 将原始类型数组包装为包装类型
*
* @param values 原始类型数组
* @return 包装类型数组
*/
public static Double[] wrap(double... values) {
if (null == values) {
return null;
}
final int length = values.length;
if (0 == length) {
return new Double[0];
}
final Double[] array = new Double[length];
for (int i = 0; i < length; i++) {
array[i] = Double.valueOf(values[i]);
}
return array;
}
/**
* 包装类数组转为原始类型数组
*
* @param values 包装类型数组
* @return 原始类型数组
*/
public static double[] unWrap(Double... values) {
if (null == values) {
return null;
}
final int length = values.length;
if (0 == length) {
return new double[0];
}
final double[] array = new double[length];
for (int i = 0; i < length; i++) {
array[i] = values[i].doubleValue();
}
return array;
}
/**
* 将原始类型数组包装为包装类型
*
* @param values 原始类型数组
* @return 包装类型数组
*/
public static Boolean[] wrap(boolean... values) {
if (null == values) {
return null;
}
final int length = values.length;
if (0 == length) {
return new Boolean[0];
}
final Boolean[] array = new Boolean[length];
for (int i = 0; i < length; i++) {
array[i] = Boolean.valueOf(values[i]);
}
return array;
}
/**
* 包装类数组转为原始类型数组
*
* @param values 包装类型数组
* @return 原始类型数组
*/
public static boolean[] unWrap(Boolean... values) {
if (null == values) {
return null;
}
final int length = values.length;
if (0 == length) {
return new boolean[0];
}
final boolean[] array = new boolean[length];
for (int i = 0; i < length; i++) {
array[i] = values[i].booleanValue();
}
return array;
}
/**
* 包装数组对象
*
* @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) {
if (null == obj) {
// throw new NullPointerException("Object check for isArray is null");
return false;
}
return 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 数组
* @param indexes 下标列表
* @return 结果
*/
public static T[] getAny(Object array, int... indexes) {
if (null == array) {
return null;
}
final T[] result = newArray(array.getClass().getComponentType(), indexes.length);
for (int i : indexes) {
result[i] = get(array, i);
}
return result;
}
/**
* 获取子数组
*
* @param 数组元素类型
* @param array 数组
* @param start 开始位置(包括)
* @param end 结束位置(不包括)
* @return 新的数组
* @since 4.2.2
* @see Arrays#copyOfRange(Object[], int, int)
*/
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.5.2
* @see Arrays#copyOfRange(Object[], int, int)
*/
public static byte[] sub(byte[] array, int start, int end) {
int length = length(array);
if (start < 0) {
start += length;
}
if (end < 0) {
end += length;
}
if (start == length) {
return new byte[0];
}
if (start > end) {
int tmp = start;
start = end;
end = tmp;
}
if (end > length) {
if (start >= length) {
return new byte[0];
}
end = length;
}
return Arrays.copyOfRange(array, start, end);
}
/**
* 获取子数组
*
* @param array 数组
* @param start 开始位置(包括)
* @param end 结束位置(不包括)
* @return 新的数组
* @since 4.5.2
* @see Arrays#copyOfRange(Object[], int, int)
*/
public static int[] sub(int[] array, int start, int end) {
int length = length(array);
if (start < 0) {
start += length;
}
if (end < 0) {
end += length;
}
if (start == length) {
return new int[0];
}
if (start > end) {
int tmp = start;
start = end;
end = tmp;
}
if (end > length) {
if (start >= length) {
return new int[0];
}
end = length;
}
return Arrays.copyOfRange(array, start, end);
}
/**
* 获取子数组
*
* @param array 数组
* @param start 开始位置(包括)
* @param end 结束位置(不包括)
* @return 新的数组
* @since 4.5.2
* @see Arrays#copyOfRange(Object[], int, int)
*/
public static long[] sub(long[] array, int start, int end) {
int length = length(array);
if (start < 0) {
start += length;
}
if (end < 0) {
end += length;
}
if (start == length) {
return new long[0];
}
if (start > end) {
int tmp = start;
start = end;
end = tmp;
}
if (end > length) {
if (start >= length) {
return new long[0];
}
end = length;
}
return Arrays.copyOfRange(array, start, end);
}
/**
* 获取子数组
*
* @param array 数组
* @param start 开始位置(包括)
* @param end 结束位置(不包括)
* @return 新的数组
* @since 4.5.2
* @see Arrays#copyOfRange(Object[], int, int)
*/
public static short[] sub(short[] array, int start, int end) {
int length = length(array);
if (start < 0) {
start += length;
}
if (end < 0) {
end += length;
}
if (start == length) {
return new short[0];
}
if (start > end) {
int tmp = start;
start = end;
end = tmp;
}
if (end > length) {
if (start >= length) {
return new short[0];
}
end = length;
}
return Arrays.copyOfRange(array, start, end);
}
/**
* 获取子数组
*
* @param array 数组
* @param start 开始位置(包括)
* @param end 结束位置(不包括)
* @return 新的数组
* @since 4.5.2
* @see Arrays#copyOfRange(Object[], int, int)
*/
public static char[] sub(char[] array, int start, int end) {
int length = length(array);
if (start < 0) {
start += length;
}
if (end < 0) {
end += length;
}
if (start == length) {
return new char[0];
}
if (start > end) {
int tmp = start;
start = end;
end = tmp;
}
if (end > length) {
if (start >= length) {
return new char[0];
}
end = length;
}
return Arrays.copyOfRange(array, start, end);
}
/**
* 获取子数组
*
* @param array 数组
* @param start 开始位置(包括)
* @param end 结束位置(不包括)
* @return 新的数组
* @since 4.5.2
* @see Arrays#copyOfRange(Object[], int, int)
*/
public static double[] sub(double[] array, int start, int end) {
int length = length(array);
if (start < 0) {
start += length;
}
if (end < 0) {
end += length;
}
if (start == length) {
return new double[0];
}
if (start > end) {
int tmp = start;
start = end;
end = tmp;
}
if (end > length) {
if (start >= length) {
return new double[0];
}
end = length;
}
return Arrays.copyOfRange(array, start, end);
}
/**
* 获取子数组
*
* @param array 数组
* @param start 开始位置(包括)
* @param end 结束位置(不包括)
* @return 新的数组
* @since 4.5.2
* @see Arrays#copyOfRange(Object[], int, int)
*/
public static float[] sub(float[] array, int start, int end) {
int length = length(array);
if (start < 0) {
start += length;
}
if (end < 0) {
end += length;
}
if (start == length) {
return new float[0];
}
if (start > end) {
int tmp = start;
start = end;
end = tmp;
}
if (end > length) {
if (start >= length) {
return new float[0];
}
end = length;
}
return Arrays.copyOfRange(array, start, end);
}
/**
* 获取子数组
*
* @param array 数组
* @param start 开始位置(包括)
* @param end 结束位置(不包括)
* @return 新的数组
* @since 4.5.2
* @see Arrays#copyOfRange(Object[], int, int)
*/
public static boolean[] sub(boolean[] array, int start, int end) {
int length = length(array);
if (start < 0) {
start += length;
}
if (end < 0) {
end += length;
}
if (start == length) {
return new boolean[0];
}
if (start > end) {
int tmp = start;
start = end;
end = tmp;
}
if (end > length) {
if (start >= length) {
return new boolean[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 list = new ArrayList<>();
for (int i = start; i < end; i += step) {
list.add(get(array, i));
}
return list.toArray();
}
/**
* 数组或集合转String
*
* @param obj 集合或数组对象
* @return 数组字符串,与集合转字符串格式相同
*/
public static String toString(Object obj) {
if (null == obj) {
return null;
}
if (obj instanceof long[]) {
return Arrays.toString((long[]) obj);
} else if (obj instanceof int[]) {
return Arrays.toString((int[]) obj);
} else if (obj instanceof short[]) {
return Arrays.toString((short[]) obj);
} else if (obj instanceof char[]) {
return Arrays.toString((char[]) obj);
} else if (obj instanceof byte[]) {
return Arrays.toString((byte[]) obj);
} else if (obj instanceof boolean[]) {
return Arrays.toString((boolean[]) obj);
} else if (obj instanceof float[]) {
return Arrays.toString((float[]) obj);
} else if (obj instanceof double[]) {
return Arrays.toString((double[]) obj);
} else if (ArrayUtil.isArray(obj)) {
// 对象数组
try {
return Arrays.deepToString((Object[]) obj);
} catch (Exception ignore) {
// ignore
}
}
return obj.toString();
}
/**
* 获取数组长度
* 如果参数为{@code null},返回0
*
*
* ArrayUtil.length(null) = 0
* ArrayUtil.length([]) = 0
* ArrayUtil.length([null]) = 1
* ArrayUtil.length([true, false]) = 2
* ArrayUtil.length([1, 2, 3]) = 3
* ArrayUtil.length(["a", "b", "c"]) = 3
*
*
* @param array 数组对象
* @return 数组长度
* @throws IllegalArgumentException 如果参数不为数组,抛出此异常
* @since 3.0.8
* @see Array#getLength(Object)
*/
public static int length(Object array) throws IllegalArgumentException {
if (null == array) {
return 0;
}
return Array.getLength(array);
}
/**
* 以 conjunction 为分隔符将数组转换为字符串
*
* @param 被处理的集合
* @param array 数组
* @param conjunction 分隔符
* @return 连接后的字符串
*/
public static String join(T[] array, CharSequence conjunction) {
return join(array, conjunction, null, null);
}
/**
* 以 conjunction 为分隔符将数组转换为字符串
*
* @param 被处理的集合
* @param array 数组
* @param conjunction 分隔符
* @param prefix 每个元素添加的前缀,null表示不添加
* @param suffix 每个元素添加的后缀,null表示不添加
* @return 连接后的字符串
* @since 4.0.10
*/
public static String join(T[] array, CharSequence conjunction, String prefix, String suffix) {
if (null == array) {
return null;
}
final StringBuilder sb = new StringBuilder();
boolean isFirst = true;
for (T item : array) {
if (isFirst) {
isFirst = false;
} else {
sb.append(conjunction);
}
if (ArrayUtil.isArray(item)) {
sb.append(join(ArrayUtil.wrap(item), conjunction, prefix, suffix));
} else if (item instanceof Iterable>) {
sb.append(IterUtil.join((Iterable>) item, conjunction, prefix, suffix));
} else if (item instanceof Iterator>) {
sb.append(IterUtil.join((Iterator>) item, conjunction, prefix, suffix));
} else {
sb.append(StrUtil.wrap(StrUtil.toString(item), prefix, suffix));
}
}
return sb.toString();
}
/**
* 以 conjunction 为分隔符将数组转换为字符串
*
* @param array 数组
* @param conjunction 分隔符
* @return 连接后的字符串
*/
public static String join(long[] array, CharSequence conjunction) {
if (null == array) {
return null;
}
final StringBuilder sb = new StringBuilder();
boolean isFirst = true;
for (long item : array) {
if (isFirst) {
isFirst = false;
} else {
sb.append(conjunction);
}
sb.append(item);
}
return sb.toString();
}
/**
* 以 conjunction 为分隔符将数组转换为字符串
*
* @param array 数组
* @param conjunction 分隔符
* @return 连接后的字符串
*/
public static String join(int[] array, CharSequence conjunction) {
if (null == array) {
return null;
}
final StringBuilder sb = new StringBuilder();
boolean isFirst = true;
for (int item : array) {
if (isFirst) {
isFirst = false;
} else {
sb.append(conjunction);
}
sb.append(item);
}
return sb.toString();
}
/**
* 以 conjunction 为分隔符将数组转换为字符串
*
* @param array 数组
* @param conjunction 分隔符
* @return 连接后的字符串
*/
public static String join(short[] array, CharSequence conjunction) {
if (null == array) {
return null;
}
final StringBuilder sb = new StringBuilder();
boolean isFirst = true;
for (short item : array) {
if (isFirst) {
isFirst = false;
} else {
sb.append(conjunction);
}
sb.append(item);
}
return sb.toString();
}
/**
* 以 conjunction 为分隔符将数组转换为字符串
*
* @param array 数组
* @param conjunction 分隔符
* @return 连接后的字符串
*/
public static String join(char[] array, CharSequence conjunction) {
if (null == array) {
return null;
}
final StringBuilder sb = new StringBuilder();
boolean isFirst = true;
for (char item : array) {
if (isFirst) {
isFirst = false;
} else {
sb.append(conjunction);
}
sb.append(item);
}
return sb.toString();
}
/**
* 以 conjunction 为分隔符将数组转换为字符串
*
* @param array 数组
* @param conjunction 分隔符
* @return 连接后的字符串
*/
public static String join(byte[] array, CharSequence conjunction) {
if (null == array) {
return null;
}
final StringBuilder sb = new StringBuilder();
boolean isFirst = true;
for (byte item : array) {
if (isFirst) {
isFirst = false;
} else {
sb.append(conjunction);
}
sb.append(item);
}
return sb.toString();
}
/**
* 以 conjunction 为分隔符将数组转换为字符串
*
* @param array 数组
* @param conjunction 分隔符
* @return 连接后的字符串
*/
public static String join(boolean[] array, CharSequence conjunction) {
if (null == array) {
return null;
}
final StringBuilder sb = new StringBuilder();
boolean isFirst = true;
for (boolean item : array) {
if (isFirst) {
isFirst = false;
} else {
sb.append(conjunction);
}
sb.append(item);
}
return sb.toString();
}
/**
* 以 conjunction 为分隔符将数组转换为字符串
*
* @param array 数组
* @param conjunction 分隔符
* @return 连接后的字符串
*/
public static String join(float[] array, CharSequence conjunction) {
if (null == array) {
return null;
}
final StringBuilder sb = new StringBuilder();
boolean isFirst = true;
for (float item : array) {
if (isFirst) {
isFirst = false;
} else {
sb.append(conjunction);
}
sb.append(item);
}
return sb.toString();
}
/**
* 以 conjunction 为分隔符将数组转换为字符串
*
* @param array 数组
* @param conjunction 分隔符
* @return 连接后的字符串
*/
public static String join(double[] array, CharSequence conjunction) {
if (null == array) {
return null;
}
final StringBuilder sb = new StringBuilder();
boolean isFirst = true;
for (double item : array) {
if (isFirst) {
isFirst = false;
} else {
sb.append(conjunction);
}
sb.append(item);
}
return sb.toString();
}
/**
* 以 conjunction 为分隔符将数组转换为字符串
*
* @param array 数组
* @param conjunction 分隔符
* @return 连接后的字符串
*/
public static String join(Object array, CharSequence conjunction) {
if (isArray(array)) {
final Class> componentType = array.getClass().getComponentType();
if (componentType.isPrimitive()) {
final String componentTypeName = componentType.getName();
switch (componentTypeName) {
case "long":
return join((long[]) array, conjunction);
case "int":
return join((int[]) array, conjunction);
case "short":
return join((short[]) array, conjunction);
case "char":
return join((char[]) array, conjunction);
case "byte":
return join((byte[]) array, conjunction);
case "boolean":
return join((boolean[]) array, conjunction);
case "float":
return join((float[]) array, conjunction);
case "double":
return join((double[]) array, conjunction);
default:
throw new UtilException("Unknown primitive type: [{}]", componentTypeName);
}
} else {
return join((Object[]) array, conjunction);
}
}
throw new UtilException(StrUtil.format("[{}] is not a Array!", array.getClass()));
}
/**
* {@link ByteBuffer} 转byte数组
*
* @param bytebuffer {@link ByteBuffer}
* @return byte数组
* @since 3.0.1
*/
public static byte[] toArray(ByteBuffer bytebuffer) {
if (false == bytebuffer.hasArray()) {
int oldPosition = bytebuffer.position();
bytebuffer.position(0);
int size = bytebuffer.limit();
byte[] buffers = new byte[size];
bytebuffer.get(buffers);
bytebuffer.position(oldPosition);
return buffers;
} else {
return Arrays.copyOfRange(bytebuffer.array(), bytebuffer.position(), bytebuffer.limit());
}
}
/**
* 将集合转为数组
*
* @param 数组元素类型
* @param iterator {@link Iterator}
* @param componentType 集合元素类型
* @return 数组
* @since 3.0.9
*/
public static T[] toArray(Iterator iterator, Class componentType) {
return toArray(CollectionUtil.newArrayList(iterator), componentType);
}
/**
* 将集合转为数组
*
* @param 数组元素类型
* @param iterable {@link Iterable}
* @param componentType 集合元素类型
* @return 数组
* @since 3.0.9
*/
public static T[] toArray(Iterable iterable, Class componentType) {
return toArray(CollectionUtil.toCollection(iterable), componentType);
}
/**
* 将集合转为数组
*
* @param 数组元素类型
* @param collection 集合
* @param componentType 集合元素类型
* @return 数组
* @since 3.0.9
*/
public static T[] toArray(Collection collection, Class componentType) {
final T[] array = newArray(componentType, collection.size());
return collection.toArray(array);
}
// ---------------------------------------------------------------------- remove
/**
* 移除数组中对应位置的元素
* copy from commons-lang
*
* @param 数组元素类型
* @param array 数组对象,可以是对象数组,也可以原始类型数组
* @param index 位置,如果位置小于0或者大于长度,返回原数组
* @return 去掉指定元素后的新数组或原数组
* @throws IllegalArgumentException 参数对象不为数组对象
* @since 3.0.8
*/
@SuppressWarnings("unchecked")
public static T[] remove(T[] array, int index) throws IllegalArgumentException {
return (T[]) remove((Object) array, index);
}
/**
* 移除数组中对应位置的元素
* copy from commons-lang
*
* @param array 数组对象,可以是对象数组,也可以原始类型数组
* @param index 位置,如果位置小于0或者大于长度,返回原数组
* @return 去掉指定元素后的新数组或原数组
* @throws IllegalArgumentException 参数对象不为数组对象
* @since 3.0.8
*/
public static long[] remove(long[] array, int index) throws IllegalArgumentException {
return (long[]) remove((Object) array, index);
}
/**
* 移除数组中对应位置的元素
* copy from commons-lang
*
* @param array 数组对象,可以是对象数组,也可以原始类型数组
* @param index 位置,如果位置小于0或者大于长度,返回原数组
* @return 去掉指定元素后的新数组或原数组
* @throws IllegalArgumentException 参数对象不为数组对象
* @since 3.0.8
*/
public static int[] remove(int[] array, int index) throws IllegalArgumentException {
return (int[]) remove((Object) array, index);
}
/**
* 移除数组中对应位置的元素
* copy from commons-lang
*
* @param array 数组对象,可以是对象数组,也可以原始类型数组
* @param index 位置,如果位置小于0或者大于长度,返回原数组
* @return 去掉指定元素后的新数组或原数组
* @throws IllegalArgumentException 参数对象不为数组对象
* @since 3.0.8
*/
public static short[] remove(short[] array, int index) throws IllegalArgumentException {
return (short[]) remove((Object) array, index);
}
/**
* 移除数组中对应位置的元素
* copy from commons-lang
*
* @param array 数组对象,可以是对象数组,也可以原始类型数组
* @param index 位置,如果位置小于0或者大于长度,返回原数组
* @return 去掉指定元素后的新数组或原数组
* @throws IllegalArgumentException 参数对象不为数组对象
* @since 3.0.8
*/
public static char[] remove(char[] array, int index) throws IllegalArgumentException {
return (char[]) remove((Object) array, index);
}
/**
* 移除数组中对应位置的元素
* copy from commons-lang
*
* @param array 数组对象,可以是对象数组,也可以原始类型数组
* @param index 位置,如果位置小于0或者大于长度,返回原数组
* @return 去掉指定元素后的新数组或原数组
* @throws IllegalArgumentException 参数对象不为数组对象
* @since 3.0.8
*/
public static byte[] remove(byte[] array, int index) throws IllegalArgumentException {
return (byte[]) remove((Object) array, index);
}
/**
* 移除数组中对应位置的元素
* copy from commons-lang
*
* @param array 数组对象,可以是对象数组,也可以原始类型数组
* @param index 位置,如果位置小于0或者大于长度,返回原数组
* @return 去掉指定元素后的新数组或原数组
* @throws IllegalArgumentException 参数对象不为数组对象
* @since 3.0.8
*/
public static double[] remove(double[] array, int index) throws IllegalArgumentException {
return (double[]) remove((Object) array, index);
}
/**
* 移除数组中对应位置的元素
* copy from commons-lang
*
* @param array 数组对象,可以是对象数组,也可以原始类型数组
* @param index 位置,如果位置小于0或者大于长度,返回原数组
* @return 去掉指定元素后的新数组或原数组
* @throws IllegalArgumentException 参数对象不为数组对象
* @since 3.0.8
*/
public static float[] remove(float[] array, int index) throws IllegalArgumentException {
return (float[]) remove((Object) array, index);
}
/**
* 移除数组中对应位置的元素
* copy from commons-lang
*
* @param array 数组对象,可以是对象数组,也可以原始类型数组
* @param index 位置,如果位置小于0或者大于长度,返回原数组
* @return 去掉指定元素后的新数组或原数组
* @throws IllegalArgumentException 参数对象不为数组对象
* @since 3.0.8
*/
public static boolean[] remove(boolean[] array, int index) throws IllegalArgumentException {
return (boolean[]) remove((Object) array, index);
}
/**
* 移除数组中对应位置的元素
* copy from commons-lang
*
* @param array 数组对象,可以是对象数组,也可以原始类型数组
* @param index 位置,如果位置小于0或者大于长度,返回原数组
* @return 去掉指定元素后的新数组或原数组
* @throws IllegalArgumentException 参数对象不为数组对象
* @since 3.0.8
*/
public static Object remove(Object array, int index) throws IllegalArgumentException {
if (null == array) {
return null;
}
int length = length(array);
if (index < 0 || index >= length) {
return array;
}
final Object result = Array.newInstance(array.getClass().getComponentType(), length - 1);
System.arraycopy(array, 0, result, 0, index);
if (index < length - 1) {
// 后半部分
System.arraycopy(array, index + 1, result, index, length - index - 1);
}
return result;
}
// ---------------------------------------------------------------------- remove
/**
* 移除数组中指定的元素
* 只会移除匹配到的第一个元素 copy from commons-lang
*
* @param 数组元素类型
* @param array 数组对象,可以是对象数组,也可以原始类型数组
* @param element 要移除的元素
* @return 去掉指定元素后的新数组或原数组
* @throws IllegalArgumentException 参数对象不为数组对象
* @since 3.0.8
*/
public static T[] removeEle(T[] array, T element) throws IllegalArgumentException {
return remove(array, indexOf(array, element));
}
/**
* 移除数组中指定的元素
* 只会移除匹配到的第一个元素 copy from commons-lang
*
* @param array 数组对象,可以是对象数组,也可以原始类型数组
* @param element 要移除的元素
* @return 去掉指定元素后的新数组或原数组
* @throws IllegalArgumentException 参数对象不为数组对象
* @since 3.0.8
*/
public static long[] removeEle(long[] array, long element) throws IllegalArgumentException {
return remove(array, indexOf(array, element));
}
/**
* 移除数组中指定的元素
* 只会移除匹配到的第一个元素 copy from commons-lang
*
* @param array 数组对象,可以是对象数组,也可以原始类型数组
* @param element 要移除的元素
* @return 去掉指定元素后的新数组或原数组
* @throws IllegalArgumentException 参数对象不为数组对象
* @since 3.0.8
*/
public static int[] removeEle(int[] array, int element) throws IllegalArgumentException {
return remove(array, indexOf(array, element));
}
/**
* 移除数组中指定的元素
* 只会移除匹配到的第一个元素 copy from commons-lang
*
* @param array 数组对象,可以是对象数组,也可以原始类型数组
* @param element 要移除的元素
* @return 去掉指定元素后的新数组或原数组
* @throws IllegalArgumentException 参数对象不为数组对象
* @since 3.0.8
*/
public static short[] removeEle(short[] array, short element) throws IllegalArgumentException {
return remove(array, indexOf(array, element));
}
/**
* 移除数组中指定的元素
* 只会移除匹配到的第一个元素 copy from commons-lang
*
* @param array 数组对象,可以是对象数组,也可以原始类型数组
* @param element 要移除的元素
* @return 去掉指定元素后的新数组或原数组
* @throws IllegalArgumentException 参数对象不为数组对象
* @since 3.0.8
*/
public static char[] removeEle(char[] array, char element) throws IllegalArgumentException {
return remove(array, indexOf(array, element));
}
/**
* 移除数组中指定的元素
* 只会移除匹配到的第一个元素 copy from commons-lang
*
* @param array 数组对象,可以是对象数组,也可以原始类型数组
* @param element 要移除的元素
* @return 去掉指定元素后的新数组或原数组
* @throws IllegalArgumentException 参数对象不为数组对象
* @since 3.0.8
*/
public static byte[] removeEle(byte[] array, byte element) throws IllegalArgumentException {
return remove(array, indexOf(array, element));
}
/**
* 移除数组中指定的元素
* 只会移除匹配到的第一个元素 copy from commons-lang
*
* @param array 数组对象,可以是对象数组,也可以原始类型数组
* @param element 要移除的元素
* @return 去掉指定元素后的新数组或原数组
* @throws IllegalArgumentException 参数对象不为数组对象
* @since 3.0.8
*/
public static double[] removeEle(double[] array, double element) throws IllegalArgumentException {
return remove(array, indexOf(array, element));
}
/**
* 移除数组中指定的元素
* 只会移除匹配到的第一个元素 copy from commons-lang
*
* @param array 数组对象,可以是对象数组,也可以原始类型数组
* @param element 要移除的元素
* @return 去掉指定元素后的新数组或原数组
* @throws IllegalArgumentException 参数对象不为数组对象
* @since 3.0.8
*/
public static float[] removeEle(float[] array, float element) throws IllegalArgumentException {
return remove(array, indexOf(array, element));
}
/**
* 移除数组中指定的元素
* 只会移除匹配到的第一个元素 copy from commons-lang
*
* @param array 数组对象,可以是对象数组,也可以原始类型数组
* @param element 要移除的元素
* @return 去掉指定元素后的新数组或原数组
* @throws IllegalArgumentException 参数对象不为数组对象
* @since 3.0.8
*/
public static boolean[] removeEle(boolean[] array, boolean element)
throws IllegalArgumentException {
return remove(array, indexOf(array, element));
}
// ------------------------------------------------------------------------------------------------------------ Reverse array
/**
* 反转数组,会变更原数组
*
* @param 数组元素类型
* @param array 数组,会变更
* @param startIndexInclusive 开始位置(包含)
* @param endIndexExclusive 结束位置(不包含)
* @return 变更后的原数组
* @since 3.0.9
*/
public static T[] reverse(
final T[] array, final int startIndexInclusive, final int endIndexExclusive) {
if (isEmpty(array)) {
return array;
}
int i = Math.max(startIndexInclusive, 0);
int j = Math.min(array.length, endIndexExclusive) - 1;
T tmp;
while (j > i) {
tmp = array[j];
array[j] = array[i];
array[i] = tmp;
j--;
i++;
}
return array;
}
/**
* 反转数组,会变更原数组
*
* @param 数组元素类型
* @param array 数组,会变更
* @return 变更后的原数组
* @since 3.0.9
*/
public static T[] reverse(final T[] array) {
return reverse(array, 0, array.length);
}
/**
* 反转数组,会变更原数组
*
* @param array 数组,会变更
* @param startIndexInclusive 其实位置(包含)
* @param endIndexExclusive 结束位置(不包含)
* @return 变更后的原数组
* @since 3.0.9
*/
public static long[] reverse(
final long[] array, final int startIndexInclusive, final int endIndexExclusive) {
if (isEmpty(array)) {
return array;
}
int i = Math.max(startIndexInclusive, 0);
int j = Math.min(array.length, endIndexExclusive) - 1;
long tmp;
while (j > i) {
tmp = array[j];
array[j] = array[i];
array[i] = tmp;
j--;
i++;
}
return array;
}
/**
* 反转数组,会变更原数组
*
* @param array 数组,会变更
* @return 变更后的原数组
* @since 3.0.9
*/
public static long[] reverse(final long[] array) {
return reverse(array, 0, array.length);
}
/**
* 反转数组,会变更原数组
*
* @param array 数组,会变更
* @param startIndexInclusive 其实位置(包含)
* @param endIndexExclusive 结束位置(不包含)
* @return 变更后的原数组
* @since 3.0.9
*/
public static int[] reverse(
final int[] array, final int startIndexInclusive, final int endIndexExclusive) {
if (isEmpty(array)) {
return array;
}
int i = Math.max(startIndexInclusive, 0);
int j = Math.min(array.length, endIndexExclusive) - 1;
int tmp;
while (j > i) {
tmp = array[j];
array[j] = array[i];
array[i] = tmp;
j--;
i++;
}
return array;
}
/**
* 反转数组,会变更原数组
*
* @param array 数组,会变更
* @return 变更后的原数组
* @since 3.0.9
*/
public static int[] reverse(final int[] array) {
return reverse(array, 0, array.length);
}
/**
* 反转数组,会变更原数组
*
* @param array 数组,会变更
* @param startIndexInclusive 其实位置(包含)
* @param endIndexExclusive 结束位置(不包含)
* @return 变更后的原数组
* @since 3.0.9
*/
public static short[] reverse(
final short[] array, final int startIndexInclusive, final int endIndexExclusive) {
if (isEmpty(array)) {
return array;
}
int i = Math.max(startIndexInclusive, 0);
int j = Math.min(array.length, endIndexExclusive) - 1;
short tmp;
while (j > i) {
tmp = array[j];
array[j] = array[i];
array[i] = tmp;
j--;
i++;
}
return array;
}
/**
* 反转数组,会变更原数组
*
* @param array 数组,会变更
* @return 变更后的原数组
* @since 3.0.9
*/
public static short[] reverse(final short[] array) {
return reverse(array, 0, array.length);
}
/**
* 反转数组,会变更原数组
*
* @param array 数组,会变更
* @param startIndexInclusive 其实位置(包含)
* @param endIndexExclusive 结束位置(不包含)
* @return 变更后的原数组
* @since 3.0.9
*/
public static char[] reverse(
final char[] array, final int startIndexInclusive, final int endIndexExclusive) {
if (isEmpty(array)) {
return array;
}
int i = Math.max(startIndexInclusive, 0);
int j = Math.min(array.length, endIndexExclusive) - 1;
char tmp;
while (j > i) {
tmp = array[j];
array[j] = array[i];
array[i] = tmp;
j--;
i++;
}
return array;
}
/**
* 反转数组,会变更原数组
*
* @param array 数组,会变更
* @return 变更后的原数组
* @since 3.0.9
*/
public static char[] reverse(final char[] array) {
return reverse(array, 0, array.length);
}
/**
* 反转数组,会变更原数组
*
* @param array 数组,会变更
* @param startIndexInclusive 其实位置(包含)
* @param endIndexExclusive 结束位置(不包含)
* @return 变更后的原数组
* @since 3.0.9
*/
public static byte[] reverse(
final byte[] array, final int startIndexInclusive, final int endIndexExclusive) {
if (isEmpty(array)) {
return array;
}
int i = Math.max(startIndexInclusive, 0);
int j = Math.min(array.length, endIndexExclusive) - 1;
byte tmp;
while (j > i) {
tmp = array[j];
array[j] = array[i];
array[i] = tmp;
j--;
i++;
}
return array;
}
/**
* 反转数组,会变更原数组
*
* @param array 数组,会变更
* @return 变更后的原数组
* @since 3.0.9
*/
public static byte[] reverse(final byte[] array) {
return reverse(array, 0, array.length);
}
/**
* 反转数组,会变更原数组
*
* @param array 数组,会变更
* @param startIndexInclusive 其实位置(包含)
* @param endIndexExclusive 结束位置(不包含)
* @return 变更后的原数组
* @since 3.0.9
*/
public static double[] reverse(
final double[] array, final int startIndexInclusive, final int endIndexExclusive) {
if (isEmpty(array)) {
return array;
}
int i = Math.max(startIndexInclusive, 0);
int j = Math.min(array.length, endIndexExclusive) - 1;
double tmp;
while (j > i) {
tmp = array[j];
array[j] = array[i];
array[i] = tmp;
j--;
i++;
}
return array;
}
/**
* 反转数组,会变更原数组
*
* @param array 数组,会变更
* @return 变更后的原数组
* @since 3.0.9
*/
public static double[] reverse(final double[] array) {
return reverse(array, 0, array.length);
}
/**
* 反转数组,会变更原数组
*
* @param array 数组,会变更
* @param startIndexInclusive 其实位置(包含)
* @param endIndexExclusive 结束位置(不包含)
* @return 变更后的原数组
* @since 3.0.9
*/
public static float[] reverse(
final float[] array, final int startIndexInclusive, final int endIndexExclusive) {
if (isEmpty(array)) {
return array;
}
int i = Math.max(startIndexInclusive, 0);
int j = Math.min(array.length, endIndexExclusive) - 1;
float tmp;
while (j > i) {
tmp = array[j];
array[j] = array[i];
array[i] = tmp;
j--;
i++;
}
return array;
}
/**
* 反转数组,会变更原数组
*
* @param array 数组,会变更
* @return 变更后的原数组
* @since 3.0.9
*/
public static float[] reverse(final float[] array) {
return reverse(array, 0, array.length);
}
/**
* 反转数组,会变更原数组
*
* @param array 数组,会变更
* @param startIndexInclusive 其实位置(包含)
* @param endIndexExclusive 结束位置(不包含)
* @return 变更后的原数组
* @since 3.0.9
*/
public static boolean[] reverse(
final boolean[] array, final int startIndexInclusive, final int endIndexExclusive) {
if (isEmpty(array)) {
return array;
}
int i = Math.max(startIndexInclusive, 0);
int j = Math.min(array.length, endIndexExclusive) - 1;
boolean tmp;
while (j > i) {
tmp = array[j];
array[j] = array[i];
array[i] = tmp;
j--;
i++;
}
return array;
}
/**
* 反转数组,会变更原数组
*
* @param array 数组,会变更
* @return 变更后的原数组
* @since 3.0.9
*/
public static boolean[] reverse(final boolean[] array) {
return reverse(array, 0, array.length);
}
// ------------------------------------------------------------------------------------------------------------ min and max
/**
* 取最小值
*
* @param 元素类型
* @param numberArray 数字数组
* @return 最小值
* @since 3.0.9
*/
public static > T min(T[] numberArray) {
if (isEmpty(numberArray)) {
throw new IllegalArgumentException("Number array must not empty !");
}
T min = numberArray[0];
for (int i = 0; i < numberArray.length; i++) {
if (ObjectUtil.compare(min, numberArray[i]) > 0) {
min = numberArray[i];
}
}
return min;
}
/**
* 取最小值
*
* @param numberArray 数字数组
* @return 最小值
* @since 3.0.9
*/
public static long min(long... numberArray) {
if (isEmpty(numberArray)) {
throw new IllegalArgumentException("Number array must not empty !");
}
long min = numberArray[0];
for (int i = 0; i < numberArray.length; i++) {
if (min > numberArray[i]) {
min = numberArray[i];
}
}
return min;
}
/**
* 取最小值
*
* @param numberArray 数字数组
* @return 最小值
* @since 3.0.9
*/
public static int min(int... numberArray) {
if (isEmpty(numberArray)) {
throw new IllegalArgumentException("Number array must not empty !");
}
int min = numberArray[0];
for (int i = 0; i < numberArray.length; i++) {
if (min > numberArray[i]) {
min = numberArray[i];
}
}
return min;
}
/**
* 取最小值
*
* @param numberArray 数字数组
* @return 最小值
* @since 3.0.9
*/
public static short min(short... numberArray) {
if (isEmpty(numberArray)) {
throw new IllegalArgumentException("Number array must not empty !");
}
short min = numberArray[0];
for (int i = 0; i < numberArray.length; i++) {
if (min > numberArray[i]) {
min = numberArray[i];
}
}
return min;
}
/**
* 取最小值
*
* @param numberArray 数字数组
* @return 最小值
* @since 3.0.9
*/
public static char min(char... numberArray) {
if (isEmpty(numberArray)) {
throw new IllegalArgumentException("Number array must not empty !");
}
char min = numberArray[0];
for (int i = 0; i < numberArray.length; i++) {
if (min > numberArray[i]) {
min = numberArray[i];
}
}
return min;
}
/**
* 取最小值
*
* @param numberArray 数字数组
* @return 最小值
* @since 3.0.9
*/
public static byte min(byte... numberArray) {
if (isEmpty(numberArray)) {
throw new IllegalArgumentException("Number array must not empty !");
}
byte min = numberArray[0];
for (int i = 0; i < numberArray.length; i++) {
if (min > numberArray[i]) {
min = numberArray[i];
}
}
return min;
}
/**
* 取最小值
*
* @param numberArray 数字数组
* @return 最小值
* @since 3.0.9
*/
public static double min(double... numberArray) {
if (isEmpty(numberArray)) {
throw new IllegalArgumentException("Number array must not empty !");
}
double min = numberArray[0];
for (int i = 0; i < numberArray.length; i++) {
if (min > numberArray[i]) {
min = numberArray[i];
}
}
return min;
}
/**
* 取最小值
*
* @param numberArray 数字数组
* @return 最小值
* @since 3.0.9
*/
public static float min(float... numberArray) {
if (isEmpty(numberArray)) {
throw new IllegalArgumentException("Number array must not empty !");
}
float min = numberArray[0];
for (int i = 0; i < numberArray.length; i++) {
if (min > numberArray[i]) {
min = numberArray[i];
}
}
return min;
}
/**
* 取最大值
*
* @param 元素类型
* @param numberArray 数字数组
* @return 最大值
* @since 3.0.9
*/
public static > T max(T[] numberArray) {
if (isEmpty(numberArray)) {
throw new IllegalArgumentException("Number array must not empty !");
}
T max = numberArray[0];
for (int i = 0; i < numberArray.length; i++) {
if (ObjectUtil.compare(max, numberArray[i]) < 0) {
max = numberArray[i];
}
}
return max;
}
/**
* 取最大值
*
* @param numberArray 数字数组
* @return 最大值
* @since 3.0.9
*/
public static long max(long... numberArray) {
if (isEmpty(numberArray)) {
throw new IllegalArgumentException("Number array must not empty !");
}
long max = numberArray[0];
for (int i = 0; i < numberArray.length; i++) {
if (max < numberArray[i]) {
max = numberArray[i];
}
}
return max;
}
/**
* 取最大值
*
* @param numberArray 数字数组
* @return 最大值
* @since 3.0.9
*/
public static int max(int... numberArray) {
if (isEmpty(numberArray)) {
throw new IllegalArgumentException("Number array must not empty !");
}
int max = numberArray[0];
for (int i = 0; i < numberArray.length; i++) {
if (max < numberArray[i]) {
max = numberArray[i];
}
}
return max;
}
/**
* 取最大值
*
* @param numberArray 数字数组
* @return 最大值
* @since 3.0.9
*/
public static short max(short... numberArray) {
if (isEmpty(numberArray)) {
throw new IllegalArgumentException("Number array must not empty !");
}
short max = numberArray[0];
for (int i = 0; i < numberArray.length; i++) {
if (max < numberArray[i]) {
max = numberArray[i];
}
}
return max;
}
/**
* 取最大值
*
* @param numberArray 数字数组
* @return 最大值
* @since 3.0.9
*/
public static char max(char... numberArray) {
if (isEmpty(numberArray)) {
throw new IllegalArgumentException("Number array must not empty !");
}
char max = numberArray[0];
for (int i = 0; i < numberArray.length; i++) {
if (max < numberArray[i]) {
max = numberArray[i];
}
}
return max;
}
/**
* 取最大值
*
* @param numberArray 数字数组
* @return 最大值
* @since 3.0.9
*/
public static byte max(byte... numberArray) {
if (isEmpty(numberArray)) {
throw new IllegalArgumentException("Number array must not empty !");
}
byte max = numberArray[0];
for (int i = 0; i < numberArray.length; i++) {
if (max < numberArray[i]) {
max = numberArray[i];
}
}
return max;
}
/**
* 取最大值
*
* @param numberArray 数字数组
* @return 最大值
* @since 3.0.9
*/
public static double max(double... numberArray) {
if (isEmpty(numberArray)) {
throw new IllegalArgumentException("Number array must not empty !");
}
double max = numberArray[0];
for (int i = 0; i < numberArray.length; i++) {
if (max < numberArray[i]) {
max = numberArray[i];
}
}
return max;
}
/**
* 取最大值
*
* @param numberArray 数字数组
* @return 最大值
* @since 3.0.9
*/
public static float max(float... numberArray) {
if (isEmpty(numberArray)) {
throw new IllegalArgumentException("Number array must not empty !");
}
float max = numberArray[0];
for (int i = 0; i < numberArray.length; i++) {
if (max < numberArray[i]) {
max = numberArray[i];
}
}
return max;
}
/**
* 交换数组中两个位置的值
*
* @param array 数组
* @param index1 位置1
* @param index2 位置2
* @return 交换后的数组,与传入数组为同一对象
* @since 4.0.7
*/
public static int[] swap(int[] array, int index1, int index2) {
if (isEmpty(array)) {
throw new IllegalArgumentException("Number array must not empty !");
}
int tmp = array[index1];
array[index1] = array[index2];
array[index2] = tmp;
return array;
}
/**
* 交换数组中两个位置的值
*
* @param array 数组
* @param index1 位置1
* @param index2 位置2
* @return 交换后的数组,与传入数组为同一对象
* @since 4.0.7
*/
public static long[] swap(long[] array, int index1, int index2) {
if (isEmpty(array)) {
throw new IllegalArgumentException("Number array must not empty !");
}
long tmp = array[index1];
array[index1] = array[index2];
array[index2] = tmp;
return array;
}
/**
* 交换数组中两个位置的值
*
* @param array 数组
* @param index1 位置1
* @param index2 位置2
* @return 交换后的数组,与传入数组为同一对象
* @since 4.0.7
*/
public static double[] swap(double[] array, int index1, int index2) {
if (isEmpty(array)) {
throw new IllegalArgumentException("Number array must not empty !");
}
double tmp = array[index1];
array[index1] = array[index2];
array[index2] = tmp;
return array;
}
/**
* 交换数组中两个位置的值
*
* @param array 数组
* @param index1 位置1
* @param index2 位置2
* @return 交换后的数组,与传入数组为同一对象
* @since 4.0.7
*/
public static float[] swap(float[] array, int index1, int index2) {
if (isEmpty(array)) {
throw new IllegalArgumentException("Number array must not empty !");
}
float tmp = array[index1];
array[index1] = array[index2];
array[index2] = tmp;
return array;
}
/**
* 交换数组中两个位置的值
*
* @param array 数组
* @param index1 位置1
* @param index2 位置2
* @return 交换后的数组,与传入数组为同一对象
* @since 4.0.7
*/
public static boolean[] swap(boolean[] array, int index1, int index2) {
if (isEmpty(array)) {
throw new IllegalArgumentException("Number array must not empty !");
}
boolean tmp = array[index1];
array[index1] = array[index2];
array[index2] = tmp;
return array;
}
/**
* 交换数组中两个位置的值
*
* @param array 数组
* @param index1 位置1
* @param index2 位置2
* @return 交换后的数组,与传入数组为同一对象
* @since 4.0.7
*/
public static byte[] swap(byte[] array, int index1, int index2) {
if (isEmpty(array)) {
throw new IllegalArgumentException("Number array must not empty !");
}
byte tmp = array[index1];
array[index1] = array[index2];
array[index2] = tmp;
return array;
}
/**
* 交换数组中两个位置的值
*
* @param array 数组
* @param index1 位置1
* @param index2 位置2
* @return 交换后的数组,与传入数组为同一对象
* @since 4.0.7
*/
public static char[] swap(char[] array, int index1, int index2) {
if (isEmpty(array)) {
throw new IllegalArgumentException("Number array must not empty !");
}
char tmp = array[index1];
array[index1] = array[index2];
array[index2] = tmp;
return array;
}
/**
* 交换数组中两个位置的值
*
* @param array 数组
* @param index1 位置1
* @param index2 位置2
* @return 交换后的数组,与传入数组为同一对象
* @since 4.0.7
*/
public static short[] swap(short[] array, int index1, int index2) {
if (isEmpty(array)) {
throw new IllegalArgumentException("Number array must not empty !");
}
short tmp = array[index1];
array[index1] = array[index2];
array[index2] = tmp;
return array;
}
/**
* 交换数组中两个位置的值
*
* @param 元素类型
* @param array 数组
* @param index1 位置1
* @param index2 位置2
* @return 交换后的数组,与传入数组为同一对象
* @since 4.0.7
*/
public static T[] swap(T[] array, int index1, int index2) {
if (isEmpty(array)) {
throw new IllegalArgumentException("Array must not empty !");
}
T tmp = array[index1];
array[index1] = array[index2];
array[index2] = tmp;
return array;
}
/**
* 交换数组中两个位置的值
*
* @param array 数组对象
* @param index1 位置1
* @param index2 位置2
* @return 交换后的数组,与传入数组为同一对象
* @since 4.0.7
*/
public static Object swap(Object array, int index1, int index2) {
if (isEmpty(array)) {
throw new IllegalArgumentException("Array must not empty !");
}
Object tmp = get(array, index1);
Array.set(array, index1, Array.get(array, index2));
Array.set(array, index2, tmp);
return array;
}
/**
* 计算{@code null}或空元素对象的个数,通过{@link ObjectUtil#isEmpty(Object)} 判断元素
*
* @param args 被检查的对象,一个或者多个
* @return 存在{@code null}的数量
* @since 4.5.18
*/
public static int emptyCount(Object... args) {
int count = 0;
if (isNotEmpty(args)) {
for (Object element : args) {
if (ObjectUtil.isEmpty(element)) {
count++;
}
}
}
return count;
}
/**
* 是否存在{@code null}或空对象,通过{@link ObjectUtil#isEmpty(Object)} 判断元素
*
* @param args 被检查对象
* @return 是否存在
* @since 4.5.18
*/
public static boolean hasEmpty(Object... args) {
if (isNotEmpty(args)) {
for (Object element : args) {
if (ObjectUtil.isEmpty(element)) {
return true;
}
}
}
return false;
}
/**
* 是否存都为{@code null}或空对象,通过{@link ObjectUtil#isEmpty(Object)} 判断元素
*
* @param args 被检查的对象,一个或者多个
* @return 是否都为空
* @since 4.5.18
*/
public static boolean isAllEmpty(Object... args) {
return emptyCount(args) == args.length;
}
/**
* 是否存都不为{@code null}或空对象,通过{@link ObjectUtil#isEmpty(Object)} 判断元素
*
* @param args 被检查的对象,一个或者多个
* @return 是否都不为空
* @since 4.5.18
*/
public static boolean isAllNotEmpty(Object... args) {
return false == hasEmpty(args);
}
/**
* 去重数组中的元素,去重后生成新的数组,原数组不变
* 此方法通过{@link LinkedHashSet} 去重
*
* @param 数组元素类型
* @param array 数组
* @return 去重后的数组
*/
@SuppressWarnings("unchecked")
public static T[] distinct(T[] array) {
if (isEmpty(array)) {
return array;
}
final Set set = new LinkedHashSet<>(array.length, 1);
Collections.addAll(set, array);
return toArray(set, (Class) getComponentType(array));
}
}