Java Arrays Class

Introduction

The Java Arrays class contains a static factory that allows arrays to be viewed as lists. Following are the important points about Arrays −

This class contains various methods for manipulating arrays (such as sorting and searching).
The methods in this class throw a NullPointerException if the specified array reference is null.

Arrays Class Declaration

Following is the declaration for java.util.Arrays class −

public class Arrays
   extends Object

Arrays Class Methods

Sr.No.	Method & Description
1	static <T> List<T> asList(T... a) This method returns a fixed-size list backed by the specified array.
2	static int binarySearch(byte[] a, byte key) This method searches the specified array of bytes for the specified value using the binary search algorithm.
3	static int binarySearch(char[] a, char key) This method searches the specified array of chars for the specified value using the binary search algorithm.
4	static int binarySearch(double[] a, double key) This method searches the specified array of doubles for the specified value using the binary search algorithm.
5	static int binarySearch(float[] a, float key) This method searches the specified array of floats for the specified value using the binary search algorithm.
6	static int binarySearch(int[] a, int key) This method searches the specified array of ints for the specified value using the binary search algorithm.
7	static int binarySearch(long[] a, int fromIndex, int toIndex, long key) This method searches a range of the specified array of longs for the specified value using the binary search algorithm.
8	static int binarySearch(Object[] a, Object key) This method searches the specified array for the specified object using the binary search algorithm.
9	static int binarySearch(short[] a, short key) This method searches the specified array of shorts for the specified value using the binary search algorithm.
10	static <T> int binarySearch(T[] a, T key, Comparator<? super T> c) This method searches the specified array for the specified object using the binary search algorithm.
11	static int compare(boolean[] a, boolean[] b) This method compares two boolean arrays lexicographically.
12	static int compare(byte[] a, byte[] b) This method compares two byte arrays lexicographically.
13	static int compare(char[] a, char[] b) This method compares two char arrays lexicographically.
14	static int compare(double[] a, double[] b) This method compares two double arrays lexicographically.
15	static int compare(float[] a, float[] b) This method compares two float arrays lexicographically.
16	static int compare(int[] a, int[] b) This method compares two int arrays lexicographically.
17	static int compare(long[] a, long[] b) This method compares two long arrays lexicographically.
18	static int compare(short[] a, short[] b) This method compares two short arrays lexicographically.
19	compareUnsigned(byte[] a, byte[] b) This method compares two byte arrays lexicographically, numerically treating elements as unsigned.
20	compareUnsigned(int[] a, int[] b) This method compares two int arrays lexicographically, numerically treating elements as unsigned.
21	compareUnsigned(long[] a, long[] b) This method compares two long arrays lexicographically, numerically treating elements as unsigned.
22	compareUnsigned(short[] a, short[] b) This method compares two short arrays lexicographically, numerically treating elements as unsigned.
23	static boolean[] copyOf(boolean[] original, int newLength) This method copies the specified array, truncating or padding with false (if necessary) so the copy has the specified length.
24	static byte[] copyOf(byte[] original, int newLength) This method copies the specified array, truncating or padding with false (if necessary) so the copy has the specified length.
25	static char[] copyOf(char[] original, int newLength) This method copies the specified array, truncating or padding with false (if necessary) so the copy has the specified length.
26	static double[] copyOf(double[] original, int newLength) This method copies the specified array, truncating or padding with false (if necessary) so the copy has the specified length.
27	static float[] copyOf(float[] original, int newLength) This method copies the specified array, truncating or padding with zeros (if necessary) so the copy has the specified length.
28	static int[] copyOf(int[] original, int newLength) This method copies the specified array, truncating or padding with zeros (if necessary) so the copy has the specified length.
29	static long[] copyOf(long[] original, int newLength) This method copies the specified array, truncating or padding with zeros (if necessary) so the copy has the specified length.
30	static short[] copyOf(short[] original, int newLength) This method copies the specified array, truncating or padding with zeros (if necessary) so the copy has the specified length.
31	static <T> T[] copyOf(T[] original, int newLength) This method copies the specified array, truncating or padding with nulls (if necessary) so the copy has the specified length.
32	static <T, U> T[] copyOf(U[] original, int newLength,Class<? extends T[]> newType) This method copies the specified array, truncating or padding with nulls (if necessary) so the copy has the specified length.
33	static boolean[] copyOfRange(boolean[] original, int from, int to) This method copies the specified range of the specified array into a new array.
34	static byte[] copyOfRange(byte[] original, int from, int to) This method copies the specified range of the specified array into a new array.
35	static char[] copyOfRange(char[] original, int from, int to) This method copies the specified range of the specified array into a new array.
36	static double[] copyOfRange(double[] original, int from, int to) This method copies the specified range of the specified array into a new array.
37	static int[] copyOfRange(int[] original, int from, int to) This method copies the specified range of the specified array into a new array.
38	static long[] copyOfRange(long[] original, int from, int to) This method copies the specified range of the specified array into a new array.
39	static short[] copyOfRange(short[] original, int from, int to) This method copies the specified range of the specified array into a new array.
40	static <T> T[] copyOfRange(T[] original, int from, int to) This method copies the specified range of the specified array into a new array.
41	static <T,U> T[] copyOfRange(U[] original, int from, int to, Class<? extends T[]> newType) This method copies the specified range of the specified array into a new array.
42	static boolean deepEquals(Object[] a1, Object[] a2) This method returns true if the two specified arrays are deeply equal to one another.
43	static int deepHashCode(Object[] a) This method returns a hash code based on the "deep contents" of the specified array.
44	static String deepToString(Object[] a) This method returns a string representation of the "deep contents" of the specified array.
45	static boolean equals(boolean[] a, boolean[] a2) This method returns true if the two specified arrays of booleans are equal to one another.
46	static boolean equals(byte[] a, byte[] a2) This method returns true if the two specified arrays of bytes are equal to one another.
47	static boolean equals(char[] a, char[] a2) This method returns true if the two specified arrays of chars are equal to one another.
48	static boolean equals(double[] a, double[] a2) This method returns true if the two specified arrays of double are equal to one another.
49	static boolean equals(float[] a, float[] a2) This method returns true if the two specified arrays of floats are equal to one another.
50	static boolean equals(int[] a, int[] a2) This method returns true if the two specified arrays of ints are equal to one another.
51	static boolean equals(long[] a, long[] a2) This method returns true if the two specified arrays of longs are equal to one another.
52	static boolean equals(short[] a, short[] a2) This method returns true if the two specified arrays of shorts are equal to one another.
53	static boolean equals(Object[] a, Object[] a2) This method returns true if the two specified arrays of Objects are equal to one another.
54	static boolean equals(T[] a, T[] a2, Comparator<? super T> cmp) This method returns true if the two specified arrays of Objects are equal to one another.
55	static void fill(boolean[] a, boolean val) This method assigns the specified boolean value to each element of the specified array of booleans.
56	static void fill(byte[] a, byte val) This method assigns the specified byte value to each element of the specified array of bytes.
57	static void fill(char[] a, char val) This method assigns the specified char value to each element of the specified array of chars.
58	static void fill(double[] a, double val) This method assigns the specified double value to each element of the specified array of doubles.
59	static void fill(float[] a, float val) This method assigns the specified float value to each element of the specified array of floats.
60	static void fill(int[] a, int val) This method assigns the specified int value to each element of the specified array of ints.
61	static void fill(long[] a, long val) This method assigns the specified long value to each element of the specified array of longs.
62	static void fill(Object[] a, Object val) This method assigns the specified Object reference to each element of the specified array of Objects.
63	static void fill(short[] a, short val) This method assigns the specified short value to each element of the specified array of shorts.
64	static int hashCode(boolean[] a) This method returns a hash code based on the contents of the specified array.
65	static int mismatch(boolean[] a, boolean[] b) This method finds and returns the index of the first mismatch between two boolean arrays, otherwise return -1 if no mismatch is found.
66	static int mismatch(byte[] a, byte[] b) This method finds and returns the index of the first mismatch between two byte arrays, otherwise return -1 if no mismatch is found.
67	static int mismatch(char[] a, char[] b) This method finds and returns the index of the first mismatch between two char arrays, otherwise return -1 if no mismatch is found.
68	static int mismatch(double[] a, double[] b) This method finds and returns the index of the first mismatch between two double arrays, otherwise return -1 if no mismatch is found.
69	static int mismatch(int[] a, int[] b) This method finds and returns the index of the first mismatch between two int arrays, otherwise return -1 if no mismatch is found.
70	static int mismatch(long[] a, long[] b) This method finds and returns the index of the first mismatch between two long arrays, otherwise return -1 if no mismatch is found.
71	static int mismatch(short[] a, short[] b) This method finds and returns the index of the first mismatch between two short arrays, otherwise return -1 if no mismatch is found.
72	static int mismatch(Object[] a, Object[] b) This method finds and returns the index of the first mismatch between two object arrays, otherwise return -1 if no mismatch is found.
73	static int mismatch(T[] a, T[] b, Comparator<? super T> cmp) This method finds and returns the index of the first mismatch between two object arrays, otherwise return -1 if no mismatch is found.
74	static void parallelPrefix(double[] array, DoubleBinaryOperator op) This method cumulates, in parallel, each element of the given array in place, using the supplied function.
75	static void parallelPrefix(int[] array, IntBinaryOperator op) This method cumulates, in parallel, each element of the given array in place, using the supplied function.
76	static void parallelPrefix(long[] array, LongBinaryOperator op) This method cumulates, in parallel, each element of the given array in place, using the supplied function.
77	static <T> void parallelPrefix(T[] array, BinaryOperator<T> op) This method cumulates, in parallel, each element of the given array in place, using the supplied function.
78	static void parallelSetAll(double[] array, IntToDoubleFunction generator) This method sets all elements of the specified array, in parallel, using the provided generator function to compute each element.
79	static void parallelSetAll(int[] array, IntUnaryOperator generator) This method sets all elements of the specified array, in parallel, using the provided generator function to compute each element.
80	static void parallelSetAll(long[] array, IntToLongFunction generator) This method sets all elements of the specified array, in parallel, using the provided generator function to compute each element.
81	static <T> void parallelSetAll(T[] array, IntFunction<? extends T> generator) This method sets all elements of the specified array, in parallel, using the provided generator function to compute each element.
82	static void parallelSort(byte[] a) This method sorts the specified array of bytes into ascending numerical order.
83	static void parallelSort(char[] a) This method sorts the specified array of chars into ascending numerical order.
84	static void parallelSort(double[] a) This method sorts the specified array of doubles into ascending numerical order.
85	static void parallelSort(float[] a) This method sorts the specified array of floats into ascending numerical order.
86	static void parallelSort(int[] a) This method sorts the specified array of ints into ascending numerical order.
87	static void parallelSort(long[] a) This method sorts the specified array of longs into ascending numerical order.
88	static void parallelSort(short[] a) This method sorts the specified array of shorts into ascending numerical order.
89	static <T extends Comparable<? super T>> void parallelSort(T[] a) This method sorts the specified array of objects into ascending order, according to the natural ordering of its elements.
90	static <T>> void parallelSort(T[] a, Comparator<? super T> cmp) This method sorts the specified array of objects into ascending order, according to the ordering provided by the Comparator instance.
91	static void setAll(double[] array, IntToDoubleFunction generator) This method sets all elements of the specified array, using the provided generator function to compute each element.
92	static void setAll(int[] array, IntUnaryOperator generator) This method sets all elements of the specified array, using the provided generator function to compute each element.
93	static void setAll(long[] array, IntToLongFunction generator) This method sets all elements of the specified array, using the provided generator function to compute each element.
94	static <T> void setAll(T[] array, IntFunction<? extends T> generator) This method sets all elements of the specified array, using the provided generator function to compute each element.
95	static Spliterator.OfDouble spliterator(double[] array) This method returns a Spliterator.OfDouble covering all of the specified array.
96	static Spliterator.OfInt spliterator(int[] array) This method returns a Spliterator.OfInt covering all of the specified array.
97	static Spliterator.OfLong spliterator(long[] array) This method returns a Spliterator.OfLong covering all of the specified array.
98	static <T> Spliterator<T> spliterator(T[] array) This method returns a Spliterator covering all of the specified array.
99	static DoubleStream stream(double[] array) This method returns a sequential DoubleStream with the specified array as its source.
100	static IntStream stream(int[] array) This method returns a sequential IntStream with the specified array as its source.
101	static LongStream stream(long[] array) This method returns a sequential LongStream with the specified array as its source.
102	static <T> Stream<T> stream(T[] array) This method returns a sequential Stream with the specified array as its source.
103	static void sort(byte[] a) This method sorts the specified array of bytes into ascending numerical order.
104	static void sort(char[] a) This method sorts the specified array of chars into ascending numerical order.
105	static void sort(double[] a) This method sorts the specified array of doubles into ascending numerical order.
106	static void sort(float[] a) This method sorts the specified array of floats into ascending numerical order.
107	static void sort(int[] a) This method sorts the specified array of ints into ascending numerical order.
108	static void sort(long[] a) This method sorts the specified array of longs into ascending numerical order.
109	static void sort(Object[] a) This method sorts the specified array of objects into ascending order, according to the natural ordering of its elements.
110	static void sort(short[] a) This method sorts the specified array of shorts into ascending numerical order.
111	static String toString(boolean[] a) This method returns a string representation of the contents of the specified array of boolean.

Methods Inherited

This class inherits methods from the following classes −

java.util.Object

Arrays Class Example

This Java example demonstrates the binarySearch() method of Arrays class.

// Importing the Arrays class
import java.util.Arrays;

// Public Main Class
public class Main {
  public static void main(String[] args) {
    // Declaring an array
    int arr[] = {8, 5, 3, 10, 2, 1, 15, 20};

    // Sorting the array
    Arrays.sort(arr);

    // Taking an element to search
    int ele = 15;

    // Using binarySearch() method to search "ele"
    System.out.println(
      ele + " presents at the index = " +
      Arrays.binarySearch(arr, ele));
  }
}

Let us compile and run the above program, this will produce the following result −

15 presents at the index = 6

Print Page