io.microsphere.util.ArrayUtils Maven / Gradle / Ivy
The newest version!
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package io.microsphere.util;
import java.lang.reflect.Array;
import java.lang.reflect.Parameter;
import java.util.Collection;
import java.util.Enumeration;
import java.util.function.BiConsumer;
import java.util.function.Consumer;
import static io.microsphere.collection.ListUtils.newArrayList;
import static io.microsphere.util.ClassUtils.isArray;
import static java.lang.reflect.Array.newInstance;
import static java.util.Collections.list;
/**
* The utilities class for {@link Array}
*
* @author Mercy
* @since 1.0.0
*/
public abstract class ArrayUtils extends BaseUtils {
/**
* An empty immutable {@code Object} array.
*/
public static final Object[] EMPTY_OBJECT_ARRAY = new Object[0];
/**
* An empty immutable {@code Class} array.
*/
public static final Class[] EMPTY_CLASS_ARRAY = new Class[0];
/**
* An empty immutable {@code String} array.
*/
public static final String[] EMPTY_STRING_ARRAY = new String[0];
/**
* An empty immutable {@code Parameter} array.
*/
public static final Parameter[] EMPTY_PARAMETER_ARRAY = new Parameter[0];
/**
* An empty immutable {@code long} array.
*/
public static final long[] EMPTY_LONG_ARRAY = new long[0];
/**
* An empty immutable {@code Long} array.
*/
public static final Long[] EMPTY_LONG_OBJECT_ARRAY = new Long[0];
/**
* An empty immutable {@code int} array.
*/
public static final int[] EMPTY_INT_ARRAY = new int[0];
/**
* An empty immutable {@code Integer} array.
*/
public static final Integer[] EMPTY_INTEGER_OBJECT_ARRAY = new Integer[0];
/**
* An empty immutable {@code short} array.
*/
public static final short[] EMPTY_SHORT_ARRAY = new short[0];
/**
* An empty immutable {@code Short} array.
*/
public static final Short[] EMPTY_SHORT_OBJECT_ARRAY = new Short[0];
/**
* An empty immutable {@code byte} array.
*/
public static final byte[] EMPTY_BYTE_ARRAY = new byte[0];
/**
* An empty immutable {@code Byte} array.
*/
public static final Byte[] EMPTY_BYTE_OBJECT_ARRAY = new Byte[0];
/**
* An empty immutable {@code double} array.
*/
public static final double[] EMPTY_DOUBLE_ARRAY = new double[0];
/**
* An empty immutable {@code Double} array.
*/
public static final Double[] EMPTY_DOUBLE_OBJECT_ARRAY = new Double[0];
/**
* An empty immutable {@code float} array.
*/
public static final float[] EMPTY_FLOAT_ARRAY = new float[0];
/**
* An empty immutable {@code Float} array.
*/
public static final Float[] EMPTY_FLOAT_OBJECT_ARRAY = new Float[0];
/**
* An empty immutable {@code boolean} array.
*/
public static final boolean[] EMPTY_BOOLEAN_ARRAY = new boolean[0];
/**
* An empty immutable {@code Boolean} array.
*/
public static final Boolean[] EMPTY_BOOLEAN_OBJECT_ARRAY = new Boolean[0];
/**
* An empty immutable {@code char} array.
*/
public static final char[] EMPTY_CHAR_ARRAY = new char[0];
/**
* An empty immutable {@code Character} array.
*/
public static final Character[] EMPTY_CHARACTER_OBJECT_ARRAY = new Character[0];
public static T[] of(T... values) {
return values;
}
public static int length(T[] values) {
return values == null ? 0 : values.length;
}
public static int size(T[] values) {
return length(values);
}
public static boolean isEmpty(T[] values) {
return length(values) == 0;
}
public static boolean isNotEmpty(T[] values) {
return !isEmpty(values);
}
public static E[] asArray(Enumeration enumeration, Class componentType) {
return asArray(list(enumeration), componentType);
}
public static E[] asArray(Iterable elements, Class componentType) {
return asArray(newArrayList(elements), componentType);
}
public static E[] asArray(Collection collection, Class componentType) {
return collection.toArray(newArray(componentType, 0));
}
public static E[] newArray(Class componentType, int length) {
return (E[]) newInstance(componentType, length);
}
public static E[] combine(E one, E... others) {
int othersLength = length(others);
Class oneType = one.getClass();
boolean oneIsArray = isArray(oneType);
if (oneIsArray) {
return combineArray((E[]) oneType.cast(one), others);
} else {
Class componentType = oneType;
int length = 1 + othersLength;
E[] values = newArray(componentType, length);
values[0] = one;
System.arraycopy(others, 0, values, 1, othersLength);
return values;
}
}
public static E[] combine(E[] one, E[]... others) {
return combineArray(one, others);
}
public static E[] combineArray(E[] one, E[]... others) {
int othersSize = length(others);
if (othersSize < 1) {
return one;
}
int oneSize = length(one);
int size = oneSize;
for (int i = 0; i < othersSize; i++) {
E[] other = others[i];
int otherLength = length(other);
size += otherLength;
}
Class componentType = one.getClass().getComponentType();
E[] newArray = newArray(componentType, size);
int pos = 0;
System.arraycopy(one, 0, newArray, pos, oneSize);
pos += oneSize;
for (int i = 0; i < othersSize; i++) {
E[] other = others[i];
int otherLength = length(other);
if (otherLength > 0) {
System.arraycopy(other, 0, newArray, pos, otherLength);
pos += otherLength;
}
}
return newArray;
}
public static void forEach(T[] values, BiConsumer indexedElementConsumer) {
int length = length(values);
for (int i = 0; i < length; i++) {
T value = values[i];
indexedElementConsumer.accept(i, value);
}
}
public static void forEach(T[] values, Consumer consumer) {
forEach(values, (i, e) -> consumer.accept(e));
}
}