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) 转换为字符串,除非它们是自身的数组。

猜你喜欢

转载自blog.csdn.net/coder__666/article/details/80212989