Skip to main content
Documents
Share
LinkedIn
Facebook
Twitter
Copy
Java keywordsIntroduction To JavaJava File HandlingJava Language BasicsJava ArraysJava Object-Oriented Programming

Java Array equals()

The Arrays.equals() method in Java is a utility function provided by the java.util.Arrays class. It is used to compare two arrays for equality. This method checks whether two arrays are equal by comparing the elements in both arrays in sequence. It is overloaded to handle arrays of different data types, including int, char, double, Object, and more.

Usage

The Arrays.equals() method is used to determine if two arrays contain the same elements in the same order. It returns true if the arrays are equal and false otherwise.

Syntax

Arrays.equals(array1, array2);
    
  • array1: The first array to be compared.
  • array2: The second array to be compared.

Examples

Example 1: Comparing Integer Arrays

import java.util.Arrays;

public class IntegerArrayEqualsExample {
    public static void main(String[] args) {
        int[] array1 = {1, 2, 3, 4, 5};
        int[] array2 = {1, 2, 3, 4, 5};
        boolean areEqual = Arrays.equals(array1, array2);
        System.out.println("Are integer arrays equal? " + areEqual);
    }
}

    

In this example, two integer arrays array1 and array2 are compared using Arrays.equals(). Since both arrays have identical elements in the same order, the method returns true.

Example 2: Comparing Character Arrays

import java.util.Arrays;

public class CharArrayEqualsExample {
    public static void main(String[] args) {
        char[] array1 = {'a', 'b', 'c'};
        char[] array2 = {'a', 'b', 'd'};
        boolean areEqual = Arrays.equals(array1, array2);
        System.out.println("Are character arrays equal? " + areEqual);
    }
}

    

Here, two character arrays are compared. The Arrays.equals() method returns false because the third elements of array1 and array2 differ ('c' vs 'd').

Example 3: Comparing Object Arrays

import java.util.Arrays;

public class ObjectArrayEqualsExample {
    public static void main(String[] args) {
        String[] array1 = {"Java", "Python", "C++"};
        String[] array2 = {"Java", "Python", "C++"};
        boolean areEqual = Arrays.equals(array1, array2);
        System.out.println("Are object arrays equal? " + areEqual);
    }
}

    

This example demonstrates comparing two arrays of String objects. The Arrays.equals() method returns true since all elements match in both arrays.

Tips and Best Practices

  • Use for Primitive Types: Arrays.equals() is efficient for comparing arrays of primitive types as it uses a straightforward element-by-element comparison.
  • Deep Comparison for Nested Arrays: For arrays containing other arrays (e.g., int[][]), use Arrays.deepEquals() to perform a deep comparison.
    int[][] array1 = {{1, 2}, {3, 4}};
    int[][] array2 = {{1, 2}, {3, 4}};
    boolean areDeepEqual = Arrays.deepEquals(array1, array2);
    
                
  • Null Handling: If either of the arrays being compared is null, Arrays.equals() returns false unless both are null, in which case it returns true.
  • Avoid Manual Loops: Instead of writing manual loops to compare arrays, use Arrays.equals() for cleaner and more readable code.