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

CKTIS / Java

Collection.size(): número de elementos de uma coleção

`Collection.size()` devolve o número de elementos como um `int`. A expressão `repo.all().size()` conta os elementos da coleção devolvida por `all()`.

Versão: Java SE 21

Sintaxe

int size();
int count = collection.size();

Collection.size é um método de instância sem argumentos da interface java.util.Collection em Java SE 21. A chamada collection.size() devolve o número de elementos como um int: 0 para uma coleção vazia e Integer.MAX_VALUE se o número for superior a Integer.MAX_VALUE. Para verificar apenas se a coleção está vazia, usa collection.isEmpty().

O método devolve o número de elementos, não a capacidade interna nem o número de valores distintos. Numa lista, cada ocorrência de um valor repetido conta separadamente. Um null guardado também conta como elemento se a coleção o permitir. ArrayList.size() é executado em tempo constante, mas Collection não o garante para todas as implementações.

Em repo.all().size(), o Java chama primeiro all() e depois size() na coleção devolvida. A contagem refere-se apenas a essa coleção, não necessariamente a todo o conteúdo do repositório. Se all() devolver null em vez de uma coleção, a chamada a size() lança NullPointerException. Um int guardado não é atualizado quando a coleção muda: volta a chamar size() para obter o novo tamanho.

Exemplos

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

public class Main {
    static final class Repository {
        private final Collection<String> items = new ArrayList<>(10);

        void add(String item) {
            items.add(item);
        }

        Collection<String> all() {
            return items;
        }
    }

    public static void main(String[] args) {
        Repository repo = new Repository();
        System.out.println(repo.all().size());

        repo.add("A");
        repo.add("A");
        int count = repo.all().size();
        System.out.println(count);

        repo.add("B");
        System.out.println(count);
        System.out.println(repo.all().size());
    }
}

Resultado

0
2
2
3

Uma capacidade inicial de `10` não significa que a lista contenha elementos: o primeiro resultado é `0`. Duas ocorrências de `"A"` dão `2`. Depois de adicionar `"B"`, o valor guardado em `count` continua a ser `2`, mas uma nova chamada a `size()` devolve `3`.

Lições relacionadas

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

Fontes