Course contentsShow
← Java
Lesson 1319 of 2,87030. Comparable and ComparatorFree lesson

The compareTo Method Signature and Return Values

Learn the method signature of compareTo and what negative, zero, and positive return values mean.

The compareTo Method Signature and Return Values

What you'll learn: You'll master the exact method signature of compareTo and understand what its return values mean for ordering objects.

The Method Signature

When you implement the Comparable<T> interface, you must provide this exact method:

public int compareTo(T other)

The method takes one parameter (the object you're comparing to) and returns an int. That integer tells Java how the current object relates to the parameter object.

Understanding the Return Values

The compareTo method uses a simple numeric convention:

  • Negative value (e.g., -1, -5, -100): The current object is less than the parameter object. Think: "I come before you."
  • Zero (0): The current object is equal to the parameter object. Think: "We're the same for ordering purposes."
  • Positive value (e.g., 1, 5, 100): The current object is greater than the parameter object. Think: "I come after you."

Analogy: Phone Book Ordering

Imagine comparing your name to another name in a phone book:

  • If your name is "Adams" and you compare to "Smith", return negative (you come first alphabetically)
  • If both names are "Johnson", return zero (same position)
  • If your name is "Zhang" and you compare to "Baker", return positive (you come later)

Example Usage

public class Student implements Comparable<Student> {
    private int id;
    
    public int compareTo(Student other) {
        if (this.id < other.id) return -1;
        if (this.id > other.id) return 1;
        return 0;
    }
}

Key Takeaway: The compareTo method returns a negative int when "this" is smaller, zero when equal, and a positive int when "this" is greater—establishing the natural order for your objects.