commons-lang3：ArrayUtils

add(boolean[] array, boolean element) 將給定的數據添加到指定的數組中，返回一個新的數組

ArrayUtils.add(null, true)          = [true]
ArrayUtils.add([true], false)       = [true, false]
ArrayUtils.add([true, false], true) = [true, false, true]

add(boolean[] array, int index, boolean element) 將給定的數據添加到指定的數組下標中，返回一個新的數組。

ArrayUtils.add(null, 0, true)          = [true]
ArrayUtils.add([true], 0, false)       = [false, true]
ArrayUtils.add([false], 1, true)       = [false, true]
ArrayUtils.add([true, false], 1, true) = [true, true, false]

byte, int, char, double, float, int, long ,short, T[] 同理

addAll(boolean[] array1, boolean... array2) 將給定的多個數據添加到指定的數組中，返回一個新的數組

ArrayUtils.addAll(array1, null)   = cloned copy of array1
ArrayUtils.addAll(null, array2)   = cloned copy of array2
ArrayUtils.addAll([], [])         = []

byte, int, char, double, float, int, long ,short, T[] 同理

clone(boolean[] array) 複製數組並返回 結果數組爲空將返回空

byte, int, char, double, float, int, long ,short, T[] 同理

contains(boolean[] array, boolean valueToFind) 檢查該數據在該數組中是否存在，返回一個boolean值

byte, int, char, double, float, int, long ,short, Object 同理

getLength(Object array) 返回該數組長度

ArrayUtils.getLength(null)            = 0
ArrayUtils.getLength([])              = 0
ArrayUtils.getLength([null])          = 1
ArrayUtils.getLength([true, false])   = 2
ArrayUtils.getLength([1, 2, 3])       = 3
ArrayUtils.getLength(["a", "b", "c"]) = 3

hashCode(Object array) 返回該數組的哈希Code碼

indexOf(boolean[] array, boolean valueToFind) 從數組的第一位開始查詢該數組中是否有指定的數值，存在返回index的數值，不然返回-1

indexOf(boolean[] array, boolean valueToFind, int startIndex) 從數組的第startIndex位開始查詢該數組中是否有指定的數值，存在返回index的數值，不然返回-1

byte, int, char, double, float, int, long ,short 同理

insert(int index, boolean[] array, boolean... values) 向指定的位置往該數組添加指定的元素，返回一個新的數組

ArrayUtils.insert(index, null, null)      = null
ArrayUtils.insert(index, array, null)     = cloned copy of 'array'
ArrayUtils.insert(index, null, values)    = null

byte, int, char, double, float, int, long ,short, T[] 同理

isEmpty(boolean[] array) 判斷該數組是否爲空，返回一個boolean值

byte, int, char, double, float, int, long ,short, Object 同理

isNotEmpty(boolean[] array) 判斷該數組是否爲空，而不是null

byte, int, char, double, float, int, long ,short, T[] 同理

isSameLength(boolean[] array1, boolean[] array2) 判斷兩個數組的長度是否同樣，當數組爲空視長度爲0。返回一個boolean值

isSameType(Object array1, Object array2) 判斷兩個數組的類型是否同樣，返回一個boolean值

isSorted(boolean[] array) 判斷該數組是否按照天然排列順序排序，返回一個boolean值

byte, int, char, double, float, int, long ,short, T[] 同理

isSorted(T[] array, Comparator<T> comparator) 判斷該數組是否按照比較器排列順序排序，返回一個boolean值

lastIndexOf(boolean[] array, boolean valueToFind) 從數組的最後一位開始往前查詢該數組中是否有指定的數值，存在返回index的數值，不然返回-1

lastIndexOf(boolean[] array, boolean valueToFind, int startIndex) 從數組的最後startIndex位開始往前查詢該數組中是否有指定的數值，存在返回index的數值，不然返回-1

byte, int, char, double, float, int, long ,short, Object 同理

nullToEmpty(boolean[] array) 將null轉換爲空的數組,若是數組不爲null,返回原數組,若是數組爲null,返回一個空的數組

byte, int, char, double, float, int, long ,short, Object, T 同理

remove(boolean[] array, int index) 刪除該數組指定位置上的元素，返回一個新的數組，全部後續元素左移（下標減1）

ArrayUtils.remove([true], 0)              = []
ArrayUtils.remove([true, false], 0)       = [false]
ArrayUtils.remove([true, false], 1)       = [true]
ArrayUtils.remove([true, true, false], 1) = [true, false]

byte, int, char, double, float, int, long ,short, T[] 同理

removeAll(boolean[] array, int... indices) 刪除該數組多個指定位置上的元素，返回一個新的數組，全部後續元素左移（下標減1）

ArrayUtils.removeAll([true, false, true], 0, 2) = [false]
ArrayUtils.removeAll([true, false, true], 1, 2) = [true]

byte, int, char, double, float, int, long ,short, T[] 同理

removeAllOccurences(boolean[] array, boolean element) 從該數組中刪除指定的元素，返回一個新的數組

byte, int, char, double, float, int, long ,short, T[] 同理

removeElement(boolean[] array, boolean element) 從該數組中刪除指定的元素，返回一個新的數組

byte, int, char, double, float, int, long ,short, T[] 同理

removeElements(boolean[] array, boolean... values) 從該數組中刪除指定數量的元素，返回一個新的數組

ArrayUtils.removeElements(null, true, false)               = null
ArrayUtils.removeElements([], true, false)                 = []
ArrayUtils.removeElements([true], false, false)            = [true]
ArrayUtils.removeElements([true, false], true, true)       = [false]
ArrayUtils.removeElements([true, false, true], true)       = [false, true]
ArrayUtils.removeElements([true, false, true], true, true) = [false]

byte, int, char, double, float, int, long ,short, T[] 同理

reverse(boolean[] array) 數組反轉

reverse(boolean[] array, int startIndexInclusive, int endIndexExclusive) 數組從指定位置區間進行反轉

byte, int, char, double, float, int, long ,short, Object 同理

shuffle(boolean[] array) 把數組中的元素按隨機順序從新排列

byte, int, char, double, float, int, long ,short, Object 同理

subarray(boolean[] array, int startIndexInclusive, int endIndexExclusive) 截取數組，按指定位置區間截取並返回一個新的數組

byte, int, char, double, float, int, long ,short, T[] 同理

swap(boolean[] array, int offset1, int offset2) 指定該數組的兩個位置的元素交換進行交換

ArrayUtils.swap([1, 2, 3], 0, 2) -> [3, 2, 1]
ArrayUtils.swap([1, 2, 3], 0, 0) -> [1, 2, 3]
ArrayUtils.swap([1, 2, 3], 1, 0) -> [2, 1, 3]
ArrayUtils.swap([1, 2, 3], 0, 5) -> [1, 2, 3]
ArrayUtils.swap([1, 2, 3], -1, 1) -> [2, 1, 3]

byte, int, char, double, float, int, long ,short, Object 同理

toArray(T... items) 建立數組

String[] array = ArrayUtils.toArray("1", "2");
String[] emptyArray = ArrayUtils.<String>toArray();

toMap(Object[] array) 將二維數組轉換成Map並返會Map

Map colorMap = ArrayUtils.toMap(new String[][] {
    {"RED", "#FF0000"},
    {"GREEN", "#00FF00"},
    {"BLUE", "#0000FF"}}
);

toObject(boolean[] array) 將基本類型數組轉換成對象類型數組並返回

byte, int, char, double, float, int, long ,short 同理

toPrimitive(Boolean[] array) 將對象類型數組轉換成基本類型數組並返回

byte, int, char, double, float, int, long ,short 同理

toString(Object array) 將數組轉換爲string字符串並返回

toStringArray(Object[] array) 將Object數組轉換爲String數組類型