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

CKTIS / Java

List.isEmpty() — verificar se uma lista está vazia

`List.isEmpty()` devolve `true` quando a lista não tem elementos. Usa o resultado para escolher um ramo ou verificar se podes ler o primeiro ou o último elemento.

Versão: Java SE 21

Sintaxe

boolean isEmpty(); // declaration in java.util.List<E>
list.isEmpty()     // instance call; true when the list has no elements
!list.isEmpty()    // true when the list has at least one element

List.isEmpty identifica o método da interface java.util.List; List.isEmpty() indica que não recebe argumentos. É um método de instância, não estático: chama-o com list.isEmpty(). Devolve um boolean: true se a lista não tiver elementos e false se tiver pelo menos um. Não altera a lista. Testa a mesma condição que list.size() == 0, mas exprime diretamente a intenção.

Uma lista vazia não é uma referência null. Chamar list.isEmpty() sobre uma referência null lança NullPointerException. Se a implementação aceitar elementos null, uma lista que contenha um desses elementos não está vazia.

Usa if (!list.isEmpty()) antes de list.get(0) ou antes de leres o primeiro e o último elemento com list.getFirst() e list.getLast() em Java 21. Numa lista vazia, get(0) lança IndexOutOfBoundsException, enquanto os dois métodos de acesso às extremidades lançam NoSuchElementException. A verificação só protege a leitura se a lista não ficar vazia entre a verificação e a leitura.

Exemplos

import java.util.List;

public class ListIsEmptyDemo {
    public static void main(String[] args) {
        showStatus("Alice", List.of());
        showStatus("Bob", List.of("review overdue"));
    }

    private static void showStatus(String name, List<String> reasons) {
        if (reasons.isEmpty()) {
            System.out.println(name + ": active");
        } else {
            System.out.println(name + ": inactive (" + reasons.get(0) + ")");
        }
    }
}

Resultado

Alice: active
Bob: inactive (review overdue)

A Alice mantém-se ativa porque a sua lista de motivos de desativação está vazia. O Bob está inativo porque a sua lista contém um motivo. O programa lê o primeiro motivo com `get(0)` apenas no ramo em que a lista não está vazia.

Lições relacionadas

  • Java · Lição 10 · Avançado · Versão: 2
  • Java · Lição 58 · Básico · Versão: 2
  • Java · Lição 34 · Intermédio · Versão: 2
  • Java · Lição 41 · Intermédio · Versão: 2

Fontes