018-Java Arrays工具类

目录

public static List asList(T... a)

public static boolean equals(boolean[] a, boolean[] a2)

public static T[] copyOf(T[] original,int newLength)

public static void fill(Object[] a,Object val)

public static void sort(Object[] a)

public static String toString(Object[] a)

public static String deepToString(Object[] a)

public static int binarySearch(T[] a,T key, Comparator c)

 

 

java.util.Arrays是一个与数组相关的工具类，里面提供了大量静态方法，用来实现数组常见的操作。

---

public static <T> List<T> asList(T... a)

返回一个受指定数组支持的固定大小的列表。（对返回列表的更改会“直接写”到数组。）此方法同 Collection.toArray() 一起，充当了基于数组的 API 与基于 collection 的 API 之间的桥梁。返回的列表是可序列化的，并且实现了 RandomAccess。此方法还提供了一个创建固定长度的列表的便捷方法，该列表被初始化为包含多个元素：

     List<String> stooges = Arrays.asList("Larry", "Moe", "Curly");

参数：

a - 支持列表的数组。

返回：

指定数组的列表视图。

---

 

public static boolean equals(boolean[] a, boolean[] a2)

如果两个指定的 boolean 型数组彼此相等，则返回 true。如果两个数组包含相同数量的元素，并且两个数组中的所有相应元素对都是相等的，则认为这两个数组是相等的。换句话说，如果两个数组以相同顺序包含相同的元素，则两个数组是相等的。此外，如果两个数组引用都为 null，则认为它们是相等的。

参数：

a - 将测试其相等性的一个数组

a2 - 将测试其相等性的另一个数组

返回：

如果两个数组相等，则返回 true

 

---

 

public static <T> T[] copyOf(T[] original,int newLength)

复制指定的数组，截取或用 null 填充（如有必要），以使副本具有指定的长度。对于在原数组和副本中都有效的所有索引，这两个数组将包含相同的值。对于在副本中有效而在原数组无效的所有索引，副本将包含 null。当且仅当指定长度大于原数组的长度时，这些索引存在。所得数组和原数组属于完全相同的类。

参数：

original - 要复制的数组

newLength - 要返回的副本的长度

返回：

原数组的副本，截取或用 null 填充以获得指定的长度

抛出：

NegativeArraySizeException - 如果 newLength 为负

NullPointerException - 如果 original 为 null

---

public static void fill(Object[] a,Object val)

将指定的 Object 引用分配给指定 Object 数组的每个元素。

参数：

a - 要填充的数组

val - 要存储在数组所有元素中的值

抛出：

ArrayStoreException - 如果指定值不是可存储在指定数组中的运行时类型

---

public static void sort(Object[] a)

根据元素的自然顺序对指定对象数组按升序进行排序。数组中的所有元素都必须实现 Comparable 接口。此外，数组中的所有元素都必须是可相互比较的（也就是说，对于数组中的任何 e1 和 e2 元素而言，e1.compareTo(e2) 不得抛出 ClassCastException）。

保证此排序是稳定的：不会因调用 sort 方法而对相等的元素进行重新排序。

该排序算法是一个经过修改的合并排序算法（其中，如果低子列表中的最高元素小于高子列表中的最低元素，则忽略合并）。此算法提供可保证的 n*log(n) 性能。

参数：

a - 要排序的数组

抛出：

ClassCastException - 如果数组包含不可相互比较的 的元素（例如，字符串和整数）。

 

---

public static String toString(Object[] a)

返回指定数组内容的字符串表示形式。字符串表示形式由数组的元素列表组成，括在方括号（"[]"）中。相邻元素用字符 ", "（逗号加空格）分隔。这些元素通过 String.valueOf(double) 转换为字符串。如果 a 为 null，则返回 "null"。如果数组包含作为元素的其他数组，则通过从 Object 中继承的 Object.toString() 方法将它们转换为字符串，这描述了它们的标识，而不是它们的内容。

此方法返回的值等于 Arrays.asList(a).toString() 返回的值，除非 a 为 null，在这种情况下返回 "null"。

参数：

a - 返回其字符串表示形式的数组

返回：

a 的字符串表示形式

从以下版本开始：

1.5

---

public static String deepToString(Object[] a)

返回指定数组“深层内容”的字符串表示形式。如果数组包含作为元素的其他数组，则字符串表示形式包含其内容等。此方法是为了将多维数组转换为字符串而设计的。

字符串表示形式由数组的元素列表组成，括在方括号（"[]"）中。相邻元素用字符 ", "（逗号加空格）分隔。这些元素通过 String.valueOf(Object) 转换为字符串，除非它们是自身的数组。

如果元素 e 是一个基本类型的数组，则通过调用 Arrays.toString(e) 的适当重载将它转换为字符串。如果元素 e 是一个引用类型的数组，则通过递归调用此方法将它转换为字符串。

为了避免无限递归，如果指定数组包含本身作为其元素，或者包含通过一个或多个数组级别对其自身的间接引用，则将自引用转换为字符串 "[...]"。例如，只包含对自身进行引用的数组将呈现为 "[[...]]"。

如果指定数组为 null，则此方法返回 "null"。

 

参数：

a - 返回其字符串表示形式的数组

返回：

a 的字符串表示形式

 

---

public static <T> int binarySearch(T[] a,T key, Comparator<? super T> c)

使用二分搜索法来搜索指定数组，以获得指定对象。在进行此调用之前，必须根据指定的比较器（通过 sort(T[], Comparator) 方法）对数组进行升序排序。如果没有对数组进行排序，则结果是不确定的。如果数组包含多个等于指定对象的元素，则无法保证找到的是哪一个。

参数：

a - 要搜索的数组

key - 要搜索的值

c - 用来对数组进行排序的比较器。null 值指示应该使用元素的自然顺序。

返回：

如果它包含在数组中，则返回搜索键的索引；否则返回 (-(插入点) - 1)。插入点 被定义为将键插入数组的那一点：即第一个大于此键的元素索引，如果数组中的所有元素都小于指定的键，则为 a.length。注意，这保证了当且仅当此键被找到时，返回的值将 >= 0。

抛出：

ClassCastException - 如果数组包含使用指定的比较器不可相互比较 的元素，或者使用此比较器无法相互比较搜索键与数组的元素。