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 elementList.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