UArrayUtil (JustToolc-码云(gitee.com))

java.lang.Object
- com.lc.utils.UArrayUtil

```
public class UArrayUtil
extends Object
```
数组工具类

Since:

0.1

Author:

LC

Field Summary

Fields
Modifier and Type Field and Description

static int INDEX_NOT_FOUND
数组中元素未找到的下标，值为-1

Fields
Modifier and Type	Field and Description
`static int`	`INDEX_NOT_FOUND` 数组中元素未找到的下标，值为-1

Constructor Summary

Constructors
Constructor and Description

UArrayUtil()

Constructors
Constructor and Description
`UArrayUtil()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static <T> T[]`	`append(T[] buffer, T... newElements)` 将新元素添加到已有数组中添加新元素会生成一个新的数组，不影响原数组
`static <T> T`	`clone(T obj)` 克隆数组，如果非数组返回`null`
`static boolean`	`contains(char[] array, char value)` 数组中是否包含元素
`static <T> boolean`	`contains(T[] array, T value)` 数组中是否包含元素
`static Object`	`copy(Object src, Object dest, int length)` 包装 `System.arraycopy(Object, int, Object, int, int)` 数组复制，缘数组和目标数组都是从位置0开始复制
`static Class<?>`	`getComponentType(Object array)` 获取数组对象的元素类型
`static <T> boolean`	`hasNull(T... array)` 是否包含`null`元素
`static int`	`indexOf(char[] array, char value)` 返回数组中指定元素所在位置，未找到返回`INDEX_NOT_FOUND`
`static <T> int`	`indexOf(T[] array, Object value)` 返回数组中指定元素所在位置，未找到返回`INDEX_NOT_FOUND`
`static <T> Object`	`insert(Object array, int index, T... newElements)` 将新元素插入到到已有数组中的某个位置添加新元素会生成一个新的数组，不影响原数组如果插入位置为为负数，从原数组从后向前计数，若大于原数组长度，则空白处用null填充
`static <T> T[]`	`insert(T[] buffer, int index, T... newElements)` 将新元素插入到到已有数组中的某个位置添加新元素会生成一个新的数组，不影响原数组如果插入位置为为负数，从原数组从后向前计数，若大于原数组长度，则空白处用null填充
`static boolean`	`isArray(Object obj)` 对象是否为数组对象
`static <T> boolean`	`isEmpty(T... array)` 数组是否为空
`static <T> boolean`	`isNotEmpty(T... array)` 数组是否为非空
`static String`	`join(Object array, CharSequence conjunction)` 以 conjunction 为分隔符将数组转换为字符串
`static <T> String`	`join(T[] array, CharSequence conjunction)` 以 conjunction 为分隔符将数组转换为字符串
`static <T> String`	`join(T[] array, CharSequence conjunction, String prefix, String suffix)` 以 conjunction 为分隔符将数组转换为字符串
`static int`	`length(Object array)` 获取数组长度如果参数为`null`，返回0
`static byte`	`max(byte... numberArray)` 取最大值
`static char`	`max(char... numberArray)` 取最大值
`static double`	`max(double... numberArray)` 取最大值
`static float`	`max(float... numberArray)` 取最大值
`static int`	`max(int... numberArray)` 取最大值
`static long`	`max(long... numberArray)` 取最大值
`static short`	`max(short... numberArray)` 取最大值
`static <T extends Comparable<? super T>> T`	`max(T[] numberArray)` 取最大值
`static double`	`min(double... numberArray)` 取最小值
`static float`	`min(float... numberArray)` 取最小值
`static int`	`min(int... numberArray)` 取最小值
`static long`	`min(long... numberArray)` 取最小值
`static short`	`min(short... numberArray)` 取最小值
`static <T extends Comparable<? super T>> T`	`min(T[] numberArray)` 取最小值
`static <T> T[]`	`newArray(Class<?> componentType, int newSize)` 新建一个空数组
`static char[]`	`reverse(char[] array)` 反转数组，会变更原数组
`static char[]`	`reverse(char[] array, int startIndexInclusive, int endIndexExclusive)` 反转数组，会变更原数组
`static String`	`toString(Object obj)` 数组或集合转String
`static Object[]`	`wrap(Object obj)` 包装数组对象

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - INDEX_NOT_FOUND
```
public static final int INDEX_NOT_FOUND
```
    数组中元素未找到的下标，值为-1
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - UArrayUtil
```
public UArrayUtil()
```
- Method Detail
  - isEmpty
```
public static <T> boolean isEmpty(T... array)
```
    数组是否为空
    
    Type Parameters:
    
    T - 数组元素类型
    
    Parameters:
    
    array - 数组
    
    Returns:
    
    是否为空
  - isNotEmpty
```
public static <T> boolean isNotEmpty(T... array)
```
    数组是否为非空
    
    Type Parameters:
    
    T - 数组元素类型
    
    Parameters:
    
    array - 数组
    
    Returns:
    
    是否为非空
  - hasNull
```
public static <T> boolean hasNull(T... array)
```
    是否包含null元素
    
    Type Parameters:
    
    T - 数组元素类型
    
    Parameters:
    
    array - 被检查的数组
    
    Returns:
    
    是否包含null元素
  - min
```
public static <T extends Comparable<? super T>> T min(T[] numberArray)
```
    取最小值
    
    Type Parameters:
    
    T - 元素类型
    
    Parameters:
    
    numberArray - 数字数组
    
    Returns:
    
    最小值
  - min
```
public static long min(long... numberArray)
```
    取最小值
    
    Parameters:
    
    numberArray - 数字数组
    
    Returns:
    
    最小值
  - min
```
public static int min(int... numberArray)
```
    取最小值
    
    Parameters:
    
    numberArray - 数字数组
    
    Returns:
    
    最小值
  - min
```
public static short min(short... numberArray)
```
    取最小值
    
    Parameters:
    
    numberArray - 数字数组
    
    Returns:
    
    最小值
  - min
```
public static double min(double... numberArray)
```
    取最小值
    
    Parameters:
    
    numberArray - 数字数组
    
    Returns:
    
    最小值
    
    See Also:
    
    min(double...)
  - min
```
public static float min(float... numberArray)
```
    取最小值
    
    Parameters:
    
    numberArray - 数字数组
    
    Returns:
    
    最小值
  - max
```
public static <T extends Comparable<? super T>> T max(T[] numberArray)
```
    取最大值
    
    Type Parameters:
    
    T - 元素类型
    
    Parameters:
    
    numberArray - 数字数组
    
    Returns:
    
    最大值
  - max
```
public static long max(long... numberArray)
```
    取最大值
    
    Parameters:
    
    numberArray - 数字数组
    
    Returns:
    
    最大值
  - max
```
public static int max(int... numberArray)
```
    取最大值
    
    Parameters:
    
    numberArray - 数字数组
    
    Returns:
    
    最大值
  - max
```
public static short max(short... numberArray)
```
    取最大值
    
    Parameters:
    
    numberArray - 数字数组
    
    Returns:
    
    最大值
  - max
```
public static char max(char... numberArray)
```
    取最大值
    
    Parameters:
    
    numberArray - 数字数组
    
    Returns:
    
    最大值
  - max
```
public static byte max(byte... numberArray)
```
    取最大值
    
    Parameters:
    
    numberArray - 数字数组
    
    Returns:
    
    最大值
  - max
```
public static double max(double... numberArray)
```
    取最大值
    
    Parameters:
    
    numberArray - 数字数组
    
    Returns:
    
    最大值
  - max
```
public static float max(float... numberArray)
```
    取最大值
    
    Parameters:
    
    numberArray - 数字数组
    
    Returns:
    
    最大值
  - isArray
```
public static boolean isArray(Object obj)
```
    对象是否为数组对象
    
    Parameters:
    
    obj - 对象
    
    Returns:
    
    是否为数组对象，如果为null 返回false
  - toString
```
public static String toString(Object obj)
```
    数组或集合转String
    
    Parameters:
    
    obj - 集合或数组对象
    
    Returns:
    
    数组字符串，与集合转字符串格式相同
  - join
```
public static <T> String join(T[] array,
                              CharSequence conjunction)
```
    以 conjunction 为分隔符将数组转换为字符串
    
    Type Parameters:
    
    T - 被处理的集合
    
    Parameters:
    
    array - 数组
    
    conjunction - 分隔符
    
    Returns:
    
    连接后的字符串
  - join
```
public static <T> String join(T[] array,
                              CharSequence conjunction,
                              String prefix,
                              String suffix)
```
    以 conjunction 为分隔符将数组转换为字符串
    
    Type Parameters:
    
    T - 被处理的集合
    
    Parameters:
    
    array - 数组
    
    conjunction - 分隔符
    
    prefix - 每个元素添加的前缀，null表示不添加
    
    suffix - 每个元素添加的后缀，null表示不添加
    
    Returns:
    
    连接后的字符串
  - join
```
public static String join(Object array,
                          CharSequence conjunction)
```
    以 conjunction 为分隔符将数组转换为字符串
    
    Parameters:
    
    array - 数组
    
    conjunction - 分隔符
    
    Returns:
    
    连接后的字符串
  - contains
```
public static boolean contains(char[] array,
                               char value)
```
    数组中是否包含元素
    
    Parameters:
    
    array - 数组
    
    value - 被检查的元素
    
    Returns:
    
    是否包含
  - indexOf
```
public static int indexOf(char[] array,
                          char value)
```
    返回数组中指定元素所在位置，未找到返回INDEX_NOT_FOUND
    
    Parameters:
    
    array - 数组
    
    value - 被检查的元素
    
    Returns:
    
    数组中指定元素所在位置，未找到返回INDEX_NOT_FOUND
  - wrap
```
public static Object[] wrap(Object obj)
```
    包装数组对象
    
    Parameters:
    
    obj - 对象，可以是对象数组或者基本类型数组
    
    Returns:
    
    包装类型数组或对象数组
    
    Throws:
    
    UtilException - 对象为非数组
  - reverse
```
public static char[] reverse(char[] array,
                             int startIndexInclusive,
                             int endIndexExclusive)
```
    反转数组，会变更原数组
    
    Parameters:
    
    array - 数组，会变更
    
    startIndexInclusive - 其实位置（包含）
    
    endIndexExclusive - 结束位置（不包含）
    
    Returns:
    
    变更后的原数组
  - reverse
```
public static char[] reverse(char[] array)
```
    反转数组，会变更原数组
    
    Parameters:
    
    array - 数组，会变更
    
    Returns:
    
    变更后的原数组
  - clone
```
public static <T> T clone(T obj)
```
    克隆数组，如果非数组返回null
    
    Type Parameters:
    
    T - 数组元素类型
    
    Parameters:
    
    obj - 数组对象
    
    Returns:
    
    克隆后的数组对象
  - newArray
```
public static <T> T[] newArray(Class<?> componentType,
                               int newSize)
```
    新建一个空数组
    
    Type Parameters:
    
    T - 数组元素类型
    
    Parameters:
    
    componentType - 元素类型
    
    newSize - 大小
    
    Returns:
    
    空数组
  - length
```
public static int length(Object array)
                  throws IllegalArgumentException
```
    获取数组长度
    如果参数为null，返回0
```
 UArrayUtil.length(null)            = 0
 UArrayUtil.length([])              = 0
 UArrayUtil.length([null])          = 1
 UArrayUtil.length([true, false])   = 2
 UArrayUtil.length([1, 2, 3])       = 3
 UArrayUtil.length(["a", "b", "c"]) = 3
 
```
    Parameters:
    
    array - 数组对象
    
    Returns:
    
    数组长度
    
    Throws:
    
    IllegalArgumentException - 如果参数不为数组，抛出此异常
    
    See Also:
    
    Array.getLength(Object)
  - insert
```
public static <T> Object insert(Object array,
                                int index,
                                T... newElements)
```
    将新元素插入到到已有数组中的某个位置
    添加新元素会生成一个新的数组，不影响原数组
    如果插入位置为为负数，从原数组从后向前计数，若大于原数组长度，则空白处用null填充
    
    Type Parameters:
    
    T - 数组元素类型
    
    Parameters:
    
    array - 已有数组
    
    index - 插入位置，此位置为对应此位置元素之前的空档
    
    newElements - 新元素
    
    Returns:
    
    新数组
  - insert
```
public static <T> T[] insert(T[] buffer,
                             int index,
                             T... newElements)
```
    将新元素插入到到已有数组中的某个位置
    添加新元素会生成一个新的数组，不影响原数组
    如果插入位置为为负数，从原数组从后向前计数，若大于原数组长度，则空白处用null填充
    
    Type Parameters:
    
    T - 数组元素类型
    
    Parameters:
    
    buffer - 已有数组
    
    index - 插入位置，此位置为对应此位置元素之前的空档
    
    newElements - 新元素
    
    Returns:
    
    新数组
  - append
```
@SafeVarargs
public static <T> T[] append(T[] buffer,
                                          T... newElements)
```
    将新元素添加到已有数组中
    添加新元素会生成一个新的数组，不影响原数组
    
    Type Parameters:
    
    T - 数组元素类型
    
    Parameters:
    
    buffer - 已有数组
    
    newElements - 新元素
    
    Returns:
    
    新数组
  - getComponentType
```
public static Class<?> getComponentType(Object array)
```
    获取数组对象的元素类型
    
    Parameters:
    
    array - 数组对象
    
    Returns:
    
    元素类型
  - contains
```
public static <T> boolean contains(T[] array,
                                   T value)
```
    数组中是否包含元素
    
    Type Parameters:
    
    T - 数组元素类型
    
    Parameters:
    
    array - 数组
    
    value - 被检查的元素
    
    Returns:
    
    是否包含
  - indexOf
```
public static <T> int indexOf(T[] array,
                              Object value)
```
    返回数组中指定元素所在位置，未找到返回INDEX_NOT_FOUND
    
    Type Parameters:
    
    T - 数组类型
    
    Parameters:
    
    array - 数组
    
    value - 被检查的元素
    
    Returns:
    
    数组中指定元素所在位置，未找到返回INDEX_NOT_FOUND
  - copy
```
public static Object copy(Object src,
                          Object dest,
                          int length)
```
    包装 System.arraycopy(Object, int, Object, int, int)
    数组复制，缘数组和目标数组都是从位置0开始复制
    
    Parameters:
    
    src - 源数组
    
    dest - 目标数组
    
    length - 拷贝数组长度
    
    Returns:
    
    目标数组

Class UArrayUtil

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

INDEX_NOT_FOUND

Constructor Detail

UArrayUtil

Method Detail

isEmpty

isNotEmpty

hasNull

min

min

min

min

min

min

max

max

max

max

max

max

max

max

isArray

toString

join

join

join

contains

indexOf

wrap

reverse

reverse

clone

newArray

length

insert

insert

append

getComponentType

contains

indexOf

copy