in this article, we will learn about the new methods that have been added to the arrays class in java 9. first, we will learn about arrays, and then the new methods added to the equals(), compare(), and mismatch() methods with examples.

arrays

java provides a data structure called the array, and they are used to store multiple values of the same datatype in a single variable. the arrays class can contain various methods for manipulating arrays and also contains static factory methods that allow arrays to view as a list.

creating an instance of an array with a variable named "arrayrefvar":

arrayrefvar = new datatype[arraysize];

new methods in the array class

java 9 has added three important methods to the arrays class:

arrays.equals()
arrays.compare()
arrays.mismatch()

arrays.equal()

the equal() method comes in java.util.arrays class. the equals() method checks whether two arrays are equal, and handles arrays of different data types, like int, char, double, and object.

in java 9, a few overloaded methods have been added to the arrays.equals() method. the new methods take fromindex and toindex parameters for the two provided arrays. these methods check the equality of the two arrays based on their relative index positions.

this method returns true if the two arrays are equal, else it returns false.

syntax

the following is the syntax for the arrays.equal() method declaration:

public static boolean equals(int[] a, int afromindex, int atoindex, int[] b, int bfromindex, int btoindex)

in the above syntax, the method returns true if two specified arrays of ints and over the specified ranges are equal to each other. the second method works the same for an array of chars.

example

below is an example of the arrays.equal() method in java:

import java.util.arrays;
public class comparearraytest {
   public static void arrayequalstest() {
      int[] existrows = {0, 1, 2, 3, 4, 5};
      int[] newrows = {3, 4, 5, 1, 2, 0};
      system.out.println(arrays.equals(existrows, newrows));
      system.out.println(arrays.equals(existrows, 1, 3, newrows, 3, 5));
      system.out.println(arrays.equals(existrows, 3, 5, newrows, 0, 2));
   }
   public static void main(string args[]) {
      comparearraytest.arrayequalstest();
   }
}

output

false
true
true

arrays.compare()

the compare() method comes in java.util.arrays class. the compare() method compares two arrays lexicographically. this method can be used for arrays of various types, such as boolean, byte, char, etc.

in java 9, a few parameters have been added to the arrays.compare() method. with the fromindex/toindex parameters that are used for relative position comparison.

this method returns 0 if the arrays are equal, a negative integer(-1) if the first array is lexicographically less, and a positive integer(1) if the first array is lexicographically greater.

syntax

the following is the syntax for the arrays.compare() method declaration:

public static int compare(int[] a, int afromindex, int atoindex, int[] b, int bfromindex, int btoindex)

in the above syntax, the method compares two int arrays lexicographically over the specified ranges.

example

below is an example of the arrays.compare() method in java:

import java.util.arrays;
public class lexicographicalarraystest {
   public static void main(string args[]) {
      lexicographicalarraystest.compareslicearraystest();
   }
   public static void compareslicearraystest() {
      int[] tommarks = {5, 6, 7, 8, 9, 10};
      int[] daisymarks = {5, 6, 7, 10, 9, 10};
      int[] marymarks = {5, 6, 7, 8};
      system.out.println(arrays.compare(tommarks, 0, 3, daisymarks, 0, 3));
      system.out.println(arrays.compare(tommarks, 0, 4, marymarks, 0, marymarks.length));
      system.out.println(arrays.compare(daisymarks, 0, 4, marymarks, 0, marymarks.length));
   }
}

output

0
0
1

arrays.mismatch()

the mismatch() method comes in java.util.arrays class and this method are used to find the first index at which two arrays differ.

in java 9, there are other overloaded methods of the arrays.mismatch() method that enables us to find and return the index of the first mismatch between two slices of arrays.

this method returns the index of the first mismatch between the two arrays, else it returns -1.

syntax

the following is the syntax for the arrays.mismatch() method declaration:

public static int mismatch(int[] a, int afromindex, int atoindex, int[] b, int bfromindex, int btoindex)

in the above syntax, the method finds and returns the relative index of the first mismatch between two int arrays over the specified range. it returns -1 if no mismatch has found. the index in the range of 0 (inclusive) up to the length (inclusive) of the smaller range.

example

below is an example of the arrays.mismatch() method in java:

import java.util.arrays;
public class mismatchmethodtest {
   public static void main(string[] args) {
      mismatchmethodtest.mismatcharraystest();
   }
   public static void mismatcharraystest() {
      int[] a = {1, 2, 3, 4, 5};
      int[] b = {1, 2, 3, 4, 5};
      int[] c = {1, 2, 4, 4, 5, 6};
      system.out.println(arrays.mismatch(a, b));
      system.out.println(arrays.mismatch(a, c));
      system.out.println(arrays.mismatch(a, 0, 2, c, 0, 2));
      system.out.println(arrays.mismatch(a, 0, 3, c, 0, 3));
      system.out.println(arrays.mismatch(a, 2, a.length, c, 2, 5));
   }
}

output

Save or share this article