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

CKTIS / Java

Collection.isEmpty() — verificar se uma coleção está vazia

`Collection.isEmpty()` devolve `true` se a coleção não tiver elementos e `false` caso contrário. A chamada não altera a coleção.

Versão: Java SE 21

Sintaxe

boolean isEmpty()

Em Java SE 21, Collection.isEmpty() é um método de instância sem argumentos, declarado na interface java.util.Collection<E>. Invoca-o num objeto que represente uma coleção, por exemplo, com items.isEmpty(). O método devolve um boolean: true se não houver elementos e false se houver pelo menos um.

A chamada não altera a coleção. Se só precisas de saber se está vazia, usa items.isEmpty() em vez de items.size() == 0: ambas as expressões dão o mesmo resultado, mas a primeira exprime diretamente a intenção. Para verificar se a coleção não está vazia, usa !items.isEmpty().

Uma coleção vazia é um objeto sem elementos, não uma referência null. Se items for null, items.isEmpty() lança uma NullPointerException. Se a coleção admitir elementos null, como acontece com ArrayList, um null guardado também conta como elemento.

Exemplos

import java.util.ArrayList;
import java.util.Collection;

public class Main {
    public static void main(String[] args) {
        Collection<String> items = new ArrayList<>();
        System.out.println(items.isEmpty());

        items.add(null);
        System.out.println(items.isEmpty());

        items.clear();
        System.out.println(items.isEmpty());
    }
}

Resultado

true
false
true

A nova `ArrayList` está vazia, pelo que o resultado é `true`. Depois de adicionar `null`, contém um elemento, pelo que o resultado é `false`. Após `clear()`, volta a não ter elementos e o resultado é `true`.

Lições relacionadas

  • Java · Lição 60 · Básico · Versão: 2
  • Java · Lição 61 · Básico · Versão: 2

Fontes