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

CKTIS / Java

Map.size() — Número de entradas num mapa

`Map.size()` devolve o número atual de associações chave–valor como um `int`. Substituir o valor de uma chave existente não aumenta o tamanho.

Versão: Java SE 21

Sintaxe

int size()

size() é um método de instância sem argumentos da interface java.util.Map. A chamada map.size() devolve o número de associações chave–valor como um int: 0 se o mapa estiver vazio e Integer.MAX_VALUE se houver mais associações do que um int pode representar. Se só precisares de saber se o mapa está vazio, usa map.isEmpty().

Cada chave presente conta como uma entrada. Duas chaves com o mesmo valor contam como duas entradas. Uma entrada com o valor null também conta se o mapa permitir valores nulos. Se put apenas substituir o valor de uma chave existente, não acrescenta nenhuma entrada. Acrescentar uma chave nova nem sempre aumenta o número de entradas: um LinkedHashMap com uma política de remoção pode remover a entrada mais antiga durante a mesma chamada a put, sem alterar o resultado de size(). O tamanho não é a capacidade: num HashMap, a capacidade é o número de compartimentos da tabela de dispersão, não o número de entradas.

Num HashMap, se nada mais alterar o mapa, map.size() < limit verifica se é possível acrescentar uma entrada para uma chave nova sem ultrapassar o limite. Num WeakHashMap, o tamanho pode diminuir sem remoção explícita quando o coletor de lixo recolhe chaves referenciadas de forma fraca. Durante atualizações concorrentes de um ConcurrentHashMap, o resultado pode refletir um estado transitório: verificar o tamanho e depois chamar put não impõe o limite de forma atómica.

Exemplos

import java.util.HashMap;
import java.util.Map;

public class Main {
    public static void main(String[] args) {
        Map<Integer, String> map = new HashMap<>();
        System.out.println(map.size());

        map.put(10, "A");
        map.put(20, "A");
        map.put(30, "B");
        System.out.println(map.size());

        map.put(30, null);
        System.out.println(map.size());

        map.put(40, "C");
        int limit = 5;
        System.out.println(map.size());
        boolean hasRoom = map.size() < limit;
        System.out.println(hasRoom);
        if (hasRoom) {
            map.put(95, "D");
        }
        System.out.println(map.size());
    }
}

Resultado

0
3
3
4
true
5

O mapa vazio tem tamanho `0`. As chaves `10` e `20` partilham um valor, mas contam separadamente, tal como a chave `30`. Substituir o valor de `30` por `null` mantém três entradas. Antes de adicionar a chave `95`, o tamanho é `4`, pelo que a comparação com o limite `5` dá `true` e a inserção aumenta o tamanho para `5`.

Lições relacionadas

  • Java · Lição 17 · Avançado · Versão: 2
  • Java · Lição 18 · Avançado · Versão: 2
  • Java · Lição 20 · Avançado · Versão: 2
  • Java · Lição 42 · Básico · Versão: 2
  • Java · Lição 40 · Intermédio · Versão: 2

Fontes