网站在线访谈栏目建设,门户网站免费奖励自己,wordpress 站内信插件,wordpress 后台输入表格有框_预览没有边框java.util 类 Arrays
java.lang.Object -java.util.Arrayspublic class Arrays extends Object此类包含用来操作数组#xff08;比如排序和搜索#xff09;的各种方法。此类还包含一个允许将数组作为列表来查看的静态工厂。
除非特别注明#xff0c;否则如果指定数组引用为 …java.util 类 Arrays
java.lang.Object -java.util.Arrayspublic class Arrays extends Object此类包含用来操作数组比如排序和搜索的各种方法。此类还包含一个允许将数组作为列表来查看的静态工厂。
除非特别注明否则如果指定数组引用为 null则此类中的方法都会抛出 NullPointerException。
此类中所含方法的文档都包括对实现 的简短描述。应该将这些描述视为实现注意事项而不应将它们视为规范 的一部分。实现者应该可以随意替代其他算法只要遵循规范本身即可。例如sort(Object[]) 使用的算法不必是一个合并排序算法但它必须是稳定的。
此类是 Java Collections Framework 的成员。从以下版本开始1.2方法摘要static T ListTasList(T... a) 返回一个受指定数组支持的固定大小的列表。static intbinarySearch(T[] a, T key) 使用二分搜索法来搜索指定的 byte 型数组以获得指定的值。static intbinarySearch(T[] a, int fromIndex, int toIndex, T key) 使用二分搜索法来搜索指定的 byte 型数组的范围以获得指定的值。static T intbinarySearch(T[] a, int fromIndex, int toIndex, T key, Comparator? super T c) 使用二分搜索法来搜索指定数组的范围以获得指定对象。static T intbinarySearch(T[] a, T key, Comparator? super T c) 使用二分搜索法来搜索指定数组以获得指定对象。static T T[]copyOf(T[] original, int newLength) 复制指定的数组截取或用 null 填充如有必要以使副本具有指定的长度。static T,U T[]copyOf(U[] original, int newLength, Class? extends T[] newType) 复制指定的数组截取或用 null 填充如有必要以使副本具有指定的长度。static T T[]copyOfRange(T[] original, int from, int to) 将指定数组的指定范围复制到一个新数组。static T,U T[]copyOfRange(U[] original, int from, int to, Class? extends T[] newType) 将指定数组的指定范围复制到一个新数组。static booleandeepEquals(Object[] a1, Object[] a2) 如果两个指定数组彼此是深层相等 的则返回 true。static intdeepHashCode(Object[] a) 基于指定数组的“深层内容”返回哈希码。static StringdeepToString(Object[] a) 返回指定数组“深层内容”的字符串表示形式。static booleanequals(T[] a, T[] a2) 如果两个指定的 T 型数组彼此相等则返回 true。static voidfill(T[] a, int fromIndex, int toIndex, T val) 将指定的 T引用分配给指定T数组指定范围中的每个元素。static voidfill(T[] a, T val) 将指定的 T引用分配给指定T数组的每个元素。static inthashCode(T[] a) 基于指定数组的内容返回哈希码。static voidsort(T[] a) 对指定的 byte 型数组按数字升序进行排序。static voidsort(T[] a, int fromIndex, int toIndex) 对指定 byte 型数组的指定范围按数字升序进行排序。static T voidsort(T[] a, Comparator? super T c) 根据指定比较器产生的顺序对指定对象数组进行排序。static T voidsort(T[] a, int fromIndex, int toIndex, Comparator? super T c) 根据指定比较器产生的顺序对指定对象数组的指定范围进行排序。static StringtoString(T[] a) 返回指定数组内容的字符串表示形式。从类 java.lang.Object 继承的方法clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitpublic static T ListT asList(T... a)
返回一个受指定数组支持的固定大小的列表。对返回列表的更改会“直接写”到数组。此方法同 Collection.toArray() 一起充当了基于数组的 API 与基于 collection 的 API 之间的桥梁。返回的列表是可序列化的并且实现了 RandomAccess。此方法还提供了一个创建固定长度的列表的便捷方法该列表被初始化为包含多个元素 ListString stooges Arrays.asList(Larry, Moe, Curly); 参数a - 支持列表的数组。返回指定数组的列表视图。binarySearch
public static int binarySearch(T[] a,T key)
使用二分搜索法来搜索指定的 T 型数组以获得指定的值。必须在进行此调用之前对数组进行排序通过 sort(T[]) 方法。如果没有对数组进行排序则结果是不确定的。如果数组包含多个带有指定值的元素则无法保证找到的是哪一个。 参数a - 要搜索的数组key - 要搜索的值返回如果它包含在数组中则返回搜索键的索引否则返回 (-(插入点) - 1)。插入点 被定义为将键插入数组的那一点即第一个大于此键的元素索引如果数组中的所有元素都小于指定的键则为 a.length。注意这保证了当且仅当此键被找到时返回的值将 0。binarySearch
public static int binarySearch(T[] a,int fromIndex,int toIndex,T key)
使用二分搜索法来搜索指定的 byte 型数组的范围以获得指定的值。必须在进行此调用之前对范围进行排序通过 sort(T[], int, int) 方法。如果没有对范围进行排序则结果是不确定的。如果范围包含多个带有指定值的元素则无法保证找到的是哪一个。 参数a - 要搜索的数组fromIndex - 要搜索的第一个元素的索引包括toIndex - 要搜索的最后一个元素的索引不包括key - 要搜索的值返回如果它包含在数组的指定范围内则返回搜索键的索引否则返回 (-(插入点) - 1)。插入点 被定义为将键插入数组的那一点即范围中第一个大于此键的元素索引如果范围中的所有元素都小于指定的键则为 toIndex。注意这保证了当且仅当此键被找到时返回的值将 0。抛出IllegalArgumentException - 如果 fromIndex toIndexArrayIndexOutOfBoundsException - 如果 fromIndex 0 或 toIndex a.length从以下版本开始1.6 binarySearch
public static T int binarySearch(T[] a,int fromIndex,int toIndex,T key,Comparator? super T c)
使用二分搜索法来搜索指定数组的范围以获得指定对象。在进行此调用之前必须根据指定的比较器通过 sort(T[], int, int, Comparator) 方法对范围进行升序排序。如果没有对范围进行排序则结果是不确定的。如果范围包含多个等于指定对象的元素则无法保证找到的是哪一个。 参数a - 要搜索的数组fromIndex - 要搜索的第一个元素的索引包括toIndex - 要搜索的最后一个元素的索引不包括key - 要搜索的值c - 用来对数组进行排序的比较器。null 值指示应该使用元素的自然顺序。返回如果它包含在数组的指定范围内则返回搜索键的索引否则返回 (-(插入点) - 1)。插入点 被定义为将键插入数组的那一点即范围中第一个大于此键的元素索引如果范围中的所有元素都小于指定的键则为 toIndex。注意这保证了当且仅当此键被找到时返回的值将 0。抛出ClassCastException - 如果范围包含使用指定的比较器不可相互比较 的元素或者使用此比较器无法相互比较搜索键与范围中的元素。IllegalArgumentException - 如果 fromIndex toIndexArrayIndexOutOfBoundsException - 如果 fromIndex 0 或 toIndex a.length从以下版本开始1.6 copyOf
public static T[] copyOf(T[] original,int newLength)
复制指定的数组截取或用 默认值 填充如有必要以使副本具有指定的长度。对于在原数组和副本中都有效的所有索引这两个数组将包含相同的值。对于在副本中有效而在原数组无效的所有索引副本将包含 默认值 。当且仅当指定长度大于原数组的长度时这些索引存在。 参数original - 要复制的数组newLength - 要返回的副本的长度返回原数组的副本截取或用 默认值 元素填充以获得指定的长度抛出NegativeArraySizeException - 如果 newLength 为负NullPointerException - 如果 original 为 null从以下版本开始1.6 copyOf
public static T,U T[] copyOf(U[] original,int newLength,Class? extends T[] newType)
复制指定的数组截取或用 null 填充如有必要以使副本具有指定的长度。对于在原数组和副本中都有效的所有索引这两个数组将包含相同的值。对于在副本中有效而在原数组无效的所有索引副本将包含 null。当且仅当指定长度大于原数组的长度时这些索引存在。所得数组属于 newType 类。 参数original - 要复制的数组newLength - 要返回的副本的长度newType - 要返回的副本的类返回原数组的副本截取或用 null 填充以获得指定的长度抛出NegativeArraySizeException - 如果 newLength 为负NullPointerException - 如果 original 为 nullArrayStoreException - 如果从 original 中复制的元素不属于存储在 newType 类数组中的运行时类型从以下版本开始1.6 copyOfRange
public static T[] copyOfRange(T[] original,int from,int to)
将指定数组的指定范围复制到一个新数组。该范围的初始索引 (from) 必须位于 0 和 original.length包括之间。original[from] 处的值放入副本的初始元素中除非 from original.length 或 from to。原数组中后续元素的值放入副本的后续元素。该范围的最后索引 (to) 必须大于等于 from可以大于 original.length在这种情况下(T)默认值 被放入索引大于等于 original.length - from 的副本的所有元素中。返回数组的长度为 to - from。 参数original - 将要从其复制一个范围的数组from - 要复制的范围的初始索引包括to - 要复制的范围的最后索引不包括。此索引可以位于数组范围之外。返回包含取自原数组指定范围的新数组截取或用 0 填充以获得所需长度抛出ArrayIndexOutOfBoundsException - 如果 from 0 或 from original.length()IllegalArgumentException - 如果 from toNullPointerException - 如果 original 为 null从以下版本开始1.6 copyOfRange
public static T,U T[] copyOfRange(U[] original,int from,int to,Class? extends T[] newType)
将指定数组的指定范围复制到一个新数组。该范围的初始索引 (from) 必须位于 0 和 original.length包括之间。original[from] 处的值放入副本的初始元素中除非 from original.length 或 from to。原数组中后续元素的值放入副本的后续元素。该范围的最后索引 (to) 必须大于等于 from可以大于 original.length在这种情况下null 被放入索引大于等于 original.length - from 的副本的所有元素中。返回数组的长度为 to - from。所得数组属于 newType 类。 参数original - 将要从其复制一个范围的数组from - 要复制的范围的初始索引包括to - 要复制的范围的最后索引不包括。此索引可以位于数组范围之外。newType - 要返回的副本的类返回包含取自原数组指定范围的新数组截取或用 null 填充以获得所需长度抛出ArrayIndexOutOfBoundsException - 如果 from 0 或 from original.length()IllegalArgumentException - 如果 from toNullPointerException - 如果 original 为 nullArrayStoreException - 如果从 original 复制的元素不属于可以存储在 newType 类数组中的运行时类型。从以下版本开始1.6 deepEquals
public static boolean deepEquals(Object[] a1,Object[] a2)
如果两个指定数组彼此是深层相等 的则返回 true。与 equals(Object[],Object[]) 方法不同此方法适用于任意深度的嵌套数组。如果两个数组引用均为 null或者它们引用了包含相同元素数量的数组并且两个数组中的所有相应元素对都是深层相等的则认为这两个数组引用是深层相等的。如果满足以下任意条件之一则两个 null 元素 e1 和 e2 可能是深层相等的e1 和 e2 都是对象引用类型的数组并且 Arrays.deepEquals(e1, e2) 将返回 true。e1 和 e2 都是相同基本类型的数组并且 Arrays.equals(e1, e2) 的适当重载将返回 true。e1 e2e1.equals(e2) 将返回 true。注意此定义支持任意深度的 null 元素。如果指定数组中的任意一个数组直接或间接通过一个或多个数组级别包含数组本身作为其元素则此方法的行为是不确定的。 参数a1 - 将测试其相等性的一个数组a2 - 将测试其相等性的另一个数组返回如果两个数组相等则返回 true从以下版本开始1.5另请参见equals(Object[],Object[])deepHashCode
public static int deepHashCode(Object[] a)
基于指定数组的“深层内容”返回哈希码。如果数组包含作为元素的其他数组则哈希码将基于其内容并以此类推直至无穷。所以在将自身包含为一个元素的数组上直接或间接通过一个或多个数组级别来调用此方法是不可接受的。这种调用的行为是不确定的。对于任何两个满足 Arrays.deepEquals(a, b) 的数组 a 和 b也可以说 Arrays.deepHashCode(a) Arrays.deepHashCode(b)。对此方法返回值的计算类似于对列表上的 List.hashCode() 返回值的计算该列表以相同的顺序包含与 a 数组相同的元素但有一点不同如果数组 a 的 e 元素本身是一个数组则不能通过调用 e.hashCode() 计算其哈希码但是如果 e 是一个基本类型数组则可以通过调用 Arrays.hashCode(e) 的适当重载来计算其哈希码或者如果 e 是一个引用类型数组则可以通过递归调用 Arrays.deepHashCode(e) 来计算其哈希码。如果 a 为 null则此方法返回 0。 参数a - 将计算其基于深层内容的哈希码的数组返回a 数组基于深层内容的哈希码从以下版本开始1.5另请参见hashCode(Object[])deepToString
public static String deepToString(Object[] a)
返回指定数组“深层内容”的字符串表示形式。如果数组包含作为元素的其他数组则字符串表示形式包含其内容等。此方法是为了将多维数组转换为字符串而设计的。字符串表示形式由数组的元素列表组成括在方括号[]中。相邻元素用字符 , 逗号加空格分隔。这些元素通过 String.valueOf(Object) 转换为字符串除非它们是自身的数组。如果元素 e 是一个基本类型的数组则通过调用 Arrays.toString(e) 的适当重载将它转换为字符串。如果元素 e 是一个引用类型的数组则通过递归调用此方法将它转换为字符串。为了避免无限递归如果指定数组包含本身作为其元素或者包含通过一个或多个数组级别对其自身的间接引用则将自引用转换为字符串 [...]。例如只包含对自身进行引用的数组将呈现为 [[...]]。如果指定数组为 null则此方法返回 null。 参数a - 返回其字符串表示形式的数组返回a 的字符串表示形式从以下版本开始1.5equals
public static boolean equals(T[] a,T[] a2)
如果两个指定的 T 数组彼此相等则返回 true。如果两个数组包含相同数量的元素并且两个数组中的所有相应元素对都是相等的则认为这两个数组是相等的。如果 (e1null ? e2null : e1.equals(e2))则认为 e1 和 e2 这两个对象是相等的 。换句话说如果两个数组以相同顺序包含相同的元素则两个数组是相等的。此外如果两个数组引用都为 null则认为它们是相等的。 参数a - 将测试其相等性的一个数组a2 - 将测试其相等性的另一个数组返回如果两个数组相等则返回 truefill
public static void fill(T[] a,int fromIndex,int toIndex,T val)
将指定的 T 值分配给指定 T 型数组指定范围中的每个元素。填充的范围从索引 fromIndex包括一直到索引 toIndex不包括。如果 fromIndextoIndex则填充范围为空。 参数a - 要填充的数组fromIndex - 要使用指定值填充的第一个元素的索引包括toIndex - 要使用指定值填充的最后一个元素的索引不包括val - 要存储在数组所有元素中的值抛出IllegalArgumentException - 如果 fromIndex toIndexArrayIndexOutOfBoundsException - 如果 fromIndex 0 或 toIndex a.lengthfill
public static void fill(T[] a,T val)
将指定的 T 值分配给指定 T 型数组的每个元素。参数a - 要填充的数组val - 要存储在数组所有元素中的值hashCode
public static int hashCode(T[] a)
基于指定数组的内容返回哈希码。如果数组包含作为元素的其他数组则哈希码将基于其标识而不是基于其内容。所以在将自身包含为一个元素的数组上直接或间接通过一个或多个数组级别来调用此方法是可接受的。对于任何两个满足 Arrays.equals(a, b) 的数组 a 和 b也可以说 Arrays.hashCode(a) Arrays.hashCode(b)。此方法返回的值等于 Arrays.asList(a).hashCode() 返回的值除非 a 为 null在这种情况下返回 0。 参数a - 将计算其基于内容的哈希码的数组返回a 数组基于内容的哈希码从以下版本开始1.5另请参见deepHashCode(T[])sort
public static void sort(Object[] a)
根据元素的自然顺序对指定对象数组按升序进行排序。数组中的所有元素都必须实现 Comparable 接口。此外数组中的所有元素都必须是可相互比较的也就是说对于数组中的任何 e1 和 e2 元素而言e1.compareTo(e2) 不得抛出 ClassCastException。保证此排序是稳定的不会因调用 sort 方法而对相等的元素进行重新排序。该排序算法是一个经过修改的合并排序算法其中如果低子列表中的最高元素小于高子列表中的最低元素则忽略合并。此算法提供可保证的 n*log(n) 性能。 参数a - 要排序的数组抛出ClassCastException - 如果数组包含不可相互比较的 的元素例如字符串和整数。sort
public static void sort(T[] a,int fromIndex,int toIndex)
根据元素的自然顺序对指定对象数组的指定范围按升序进行排序。排序的范围从索引 fromIndex包括一直到索引 toIndex不包括。如果 fromIndextoIndex则排序范围为空。此范围中的所有元素都必须实现 Comparable 接口。此外此范围中的所有元素都必须是可相互比较的也就是说对于数组中的任何 e1 和 e2 元素而言e1.compareTo(e2) 不得抛出 ClassCastException。保证此排序是稳定的不会因调用 sort 方法而对相等的元素进行重新排序。该排序算法是一个经过修改的合并排序算法其中如果低子列表中的最高元素小于高子列表中的最低元素则忽略合并。此算法提供可保证的 n*log(n) 性能。 参数a - 要排序的数组fromIndex - 要排序的第一个元素的索引包括toIndex - 要排序的最后一个元素的索引不包括抛出IllegalArgumentException - 如果 fromIndex toIndexArrayIndexOutOfBoundsException - 如果 fromIndex 0 或 toIndex a.lengthClassCastException - 如果数组包含不可相互比较的 的元素例如字符串和整数。sort
public static T void sort(T[] a,Comparator? super T c)
根据指定比较器产生的顺序对指定对象数组进行排序。数组中的所有元素都必须是通过指定比较器可相互比较的也就是说对于数组中的任何 e1 和 e2 元素而言c.compare(e1, e2) 不得抛出 ClassCastException。保证此排序是稳定的不会因调用 sort 方法而对相等的元素进行重新排序。该排序算法是一个经过修改的合并排序算法其中如果低子列表中的最高元素小于高子列表中的最低元素则忽略合并。此算法提供可保证的 n*log(n) 性能。 参数a - 要排序的数组c - 确定数组顺序的比较器。null 值指示应该使用元素的自然顺序。抛出ClassCastException - 如果数组包含使用指定的比较器不可相互比较的 的元素。sort
public static T void sort(T[] a,int fromIndex,int toIndex,Comparator? super T c)
根据指定比较器产生的顺序对指定对象数组的指定范围进行排序。排序的范围从索引 fromIndex包括一直到索引 toIndex不包括。如果 fromIndextoIndex则排序范围为空。此范围内的所有元素都必须是通过指定比较器可相互比较的也就是说对于该范围中的任何 e1 和 e2 元素而言c.compare(e1, e2) 不得抛出 ClassCastException。保证此排序是稳定的不会因调用 sort 方法而对相等的元素进行重新排序。该排序算法是一个经过修改的合并排序算法其中如果低子列表中的最高元素小于高子列表中的最低元素则忽略合并。此算法提供可保证的 n*log(n) 性能。 参数a - 要排序的数组fromIndex - 要排序的第一个元素的索引包括toIndex - 要排序的最后一个元素的索引不包括c - 确定数组顺序的比较器。null 值指示应该使用元素的自然顺序。抛出ClassCastException - 如果数组包含使用指定的比较器不可相互比较的 的元素。IllegalArgumentException - 如果 fromIndex toIndexArrayIndexOutOfBoundsException - 如果 fromIndex 0 或 toIndex a.lengthtoString
public static String toString(T[] a)
返回指定数组内容的字符串表示形式。如果数组包含作为元素的其他数组则通过从 T 中继承的 T.toString() 方法将它们转换为字符串这描述了它们的标识而不是它们的内容。此方法返回的值等于 Arrays.asList(a).toString() 返回的值除非 a 为 null在这种情况下返回 null。 参数a - 返回其字符串表示形式的数组返回a 的字符串表示形式从以下版本开始1.5另请参见deepToString(T[])
