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