Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Comparator.nullsLast: colocar os valores null no fim

Coloca `null` depois de todos os outros valores de uma chave de ordenação, por exemplo ao ordenar pessoas por apelido e depois por nome próprio.

Versão: Java SE 21

Sintaxe

static <T> Comparator<T> nullsLast(Comparator<? super T> comparator)

Comparator.nullsLast é um método estático da interface java.util.Comparator, disponível desde o Java 8. Devolve um comparador que coloca null depois de qualquer valor diferente de null. Comparar dois valores null devolve 0. O comparador fornecido só é usado quando ambos os valores são diferentes de null.

Em Comparator.nullsLast(null), o argumento null indica que não há comparador para os valores diferentes de null, pelo que todos ficam empatados. Para manter a sua ordem natural, passa Comparator.naturalOrder(). Uma cadeia de caracteres vazia "" não é null.

Se os objetos não forem null, mas as suas chaves puderem sê-lo, passa o comparador de chaves a Comparator.comparing e, para uma segunda chave, a thenComparing. A segunda chave só desempata quando a primeira comparação devolve 0, incluindo quando ambos os apelidos são null. Se um elemento da lista também puder ser null, envolve ainda o comparador de objetos completo com nullsLast, para que não seja chamada nenhuma função de extração de chaves sobre esse elemento.

Para inverter a ordem natural dos valores diferentes de null e manter null no fim, usa Comparator.nullsLast(Comparator.reverseOrder()). Chamar reversed() no comparador final inverte toda a ordem e coloca null no início.

Exemplos

import java.util.ArrayList;
import java.util.Comparator;
import java.util.List;

public class Main {
    record Person(String lastName, String firstName) {}

    public static void main(String[] args) {
        var people = new ArrayList<>(List.of(
                new Person(null, "Zoe"),
                new Person("Lee", null),
                new Person("Lee", "Mia"),
                new Person("Adams", null),
                new Person("Lee", "Ava")
        ));

        Comparator<String> nameOrder = Comparator.nullsLast(Comparator.naturalOrder());
        Comparator<Person> personOrder = Comparator
                .comparing(Person::lastName, nameOrder)
                .thenComparing(Person::firstName, nameOrder);

        people.sort(personOrder);
        for (Person person : people) {
            System.out.println(person.lastName() + ", " + person.firstName());
        }
    }
}

Resultado

Adams, null
Lee, Ava
Lee, Mia
Lee, null
null, Zoe

`Adams, null` surge antes de todas as entradas `Lee`, porque o apelido é comparado primeiro. No grupo `Lee`, o nome próprio em falta fica no fim, e a pessoa sem apelido surge depois de todas as que têm apelido.

Lições relacionadas

  • Java · Lição 35 · Intermédio · Versão: 2

Fontes