Java常用API 之 java.util.Arrays（附解析和示例）_06

java.util.Arrays直接继承自Object类。

Arrays类包含用来操作数组（比如排序和搜索）的各种方法，还包含一个允许将数组作为列表来查看的静态工厂。

此类中所含方法的文档都包括对实现 的简短描述。应该将这些描述视为实现注意事项，而不应将它们视为规范 的一部分。实现者应该可以随意替代其他算法，只要遵循规范本身即可。（例如，sort(Object[]) 使用的算法不必是一个合并排序算法，但它必须是稳定的。）

Arrays类是 Java Collections Framework 的成员。

-----------------------------------------------------静态方法------------------------------------------------

静态方法（直接用Arrays.xxx( )调用)

public static void sort(Object[ ] a)	根据元素的自然顺序（指Comparable接口中的CompareTo方法）对指定对象数组按升序进行排序。 数组中的所有元素都必须实现 Comparable 接口。 数组中的所有元素都必须是可相互比较的，比如字符串与数字作比较是不行的。 保证此排序是稳定的：不会因调用 sort 方法而对相等的元素进行重新排序。 该排序算法是一个经过修改的合并排序算法（其中，如果低子列表中的最高元素小于高子列表中的最低元素，则忽略合并）。 此算法提供可保证的 n*log(n) 性能。
public static void sort(Object[] a,  int fromIndex, int toIndex)	根据元素的自然顺序对指定对象数组的指定范围按升序进行排序。
public static <T> void sort(T[ ] a, Comparator<? super T> c)	根据指定比较器产生的顺序对指定对象数组进行排序。
public static <T> void sort(T[ ] a, int fromIndex, int toIndex, Comparator<? super T> c)	根据指定比较器产生的顺序对指定对象数组的指定范围进行排序。
public static int binarySearch( Object[ ] a, Object key)	使用二分搜索法来搜索指定数组，以获得指定对象。 在进行此调用之前，必须根据元素的自然顺序对数组进行升序排序。（通过 sort(Object[], int, int) 方法）。如果没有对范围进行排序，则结果是不确定的。 如果数组包含多个等于指定对象的元素，则无法保证找到的是哪一个。 如果要搜索的元素包含在数组中，则返回搜索键的索引；否则返回 (-(插入点) - 1)。 插入点 被定义为将键插入数组的那一点：即第一个大于此键的元素索引，如果数组中的所有元素都小于指定的键，则为 a.length。
public static int binarySearch(Object[ ] a, int fromIndex, int toIndex, Object key)	使用二分搜索法来搜索指定数组的范围，以获得指定对象。
public static <T> int binarySearch(T[ ] a,  T key, Comparator<? super T> c)	使用二分搜索法来搜索指定数组，以获得指定对象。在进行此调用之前，必须根据指定的比较器（通过 sort(T[ ], Comparator) 方法）对范围进行升序排序。如果没有对范围进行排序，则结果是不确定的。
public static int binarySearch(Object[ ] a, int fromIndex, int toIndex, Comparator<? super T> c  )	使用二分搜索法来搜索指定数组的范围，以获得指定对象。
public static boolean equals(Object[ ] a, Object[ ] a2)	如果两个数组以相同顺序包含相同的元素，则两个数组是相等的。此外，如果两个数组引用都为 null，则认为它们是相等的。
public static void fill(Object[ ] a,Object val)	将指定的 Object 引用分配给指定 Object 数组的每个元素。
public static void fill(Object[ ] a, int fromIndex, int toIndex, Object val)	将指定的 Object 引用分配给指定 Object 数组指定范围中的每个元素。填充的范围从索引
public static <T> T[ ] copyOf(T[ ] original, int newLength)	复制指定的数组，为使副本具有指定的长度，可能会用null填充。 所得数组与原数组属于相同的类
public static <T,U> T[ ] copyOf(U[] original, int newLength, Class<? extends T[]> newType)	复制指定的数组，为使副本具有指定的长度，可能会用null填充。 所得数组属于newType类。
public static <T> T[ ] copyOfRange(T[ ] original, int from, int to)	将指定数组的指定范围复制到一个新数组。该范围的初始索引 (from) 必须位于 0 和 original.length（包括）之间。 所得数组与原数组属于相同的类。
public static <T,U> T[ ] copyOfRange(U[ ] original,int from, int to, Class<? extends T[ ]> newType)	将指定数组的指定范围复制到一个新数组。该范围的初始索引 (from) 必须位于 0 和 original.length（包括）之间。 所得数组属于newType类。
public static <T> List<T> asList(T... a)	返回一个受指定数组支持的固定大小的列表视图。（对返回列表的更改会“直接写”到数组。）此方法同 Collection.toArray() 一起，充当了基于数组的 API 与基于 collection 的 API 之间的桥梁。返回的列表是可序列化的，并且实现了 RandomAccess。 此方法还提供了一个创建固定长度的列表的便捷方法，该列表被初始化为包含多个元素： 例：List<String> stooges = Arrays.asList("Larry", "Moe", "Curly");
public static int hashCode(Object[ ] a)	基于指定数组的内容返回哈希码。如果数组包含其他数组，则哈希码将基于其标识，而不是基于其内容。 此方法返回的值等于 Arrays.asList(a).hashCode() 返回的值，除非 a 为 null，在这种情况下返回 0。
public static int deepHashCode(Object[ ] a)	基于指定数组的“深层内容”返回哈希码。如果数组包含作为元素的其他数组，则哈希码将基于其内容，并以此类推，直至无穷。这种调用的行为是不确定的。
public static boolean deepEquals(Object[] a1, Object[ ] a2)	如果两个指定数组彼此是深层相等 的，则返回 true。与 equals(Object[],Object[]) 方法不同，此方法适用于任意深度的嵌套数组。
public static String toString(Object[ ] a)	返回指定数组内容的字符串表示形式。如果数组包含作为元素的其他数组，则通过从 Object 中继承的 Object.toString() 方法将它们转换为字符串，这描述了它们的标识，而不是它们的内容。

public static String deepToString(Object[ ] a)

返回指定数组“深层内容”的字符串表示形式。如果数组包含作为元素的其他数组，则字符串表示形式包含其内容等。 此方法是为了将多维数组转换为字符串而设计的。 字符串表示形式由数组的元素列表组成，括在方括号（"[ ]"）中。相邻元素用字符 ", "（逗号加空格）分隔。这些元素通过 String.valueOf(Object) 转换为字符串，除非它们是自身的数组。