All Downloads are FREE. Search and download functionalities are using the official Maven repository.
  • Log In
  • Register

    • org.jtrim2.collections.Equality Maven / Gradle / Ivy

    There is a newer version: 2.0.7
    Show newest version
    package org.jtrim2.collections;

import java.util.Objects;

/**
 * Defines static factory methods for {@link EqualityComparator} instances.
 */
public final class Equality {
    /**
     * Returns an {@code EqualityComparator} which compares objects based on
     * their {@link Object#equals(Object) equals} method. That is, the
     * comparator returns the same value for the comparison as the static
     * method {@link java.util.Objects#equals(Object, Object)}.
     *
     * @return an {@code EqualityComparator} which compares objects based on
     *   their {@link Object#equals(Object) equals} method. This method never
     *   returns {@code null}.
     */
    public static EqualityComparator naturalEquality() {
        return Objects::equals;
    }

    /**
     * Returns an {@code EqualityComparator} which compares objects based on
     * their references. That is, the comparator returns the same value as a
     * reference comparison (i.e.: "==").
     *
     * @return an {@code EqualityComparator} which compares objects based on
     *   their {@link Object#equals(Object) equals} method. This method never
     *   returns {@code null}.
     */
    public static EqualityComparator referenceEquality() {
        return (a, b) -> a == b;
    }

    private Equality() {
        throw new AssertionError();
    }
}
    
    
    
    

    




    
    
    © 2015 - 2025 Weber Informatics LLC | Privacy Policy